SymGetOptions

The SymGetOptions function returns the current options mask.

DWORD SymGetOptions(VOID);

Parameters

This function has no parameters.

Return Values

The SymGetOptions function always returns the current options mask. Zero is a valid value and indicates that all options are turned off. The options values are masks that are combined using the OR operator to form a valid options value. The valid mask values are:

Value Meaning
SYMOPT_CASE_INSENSITIVE All symbol searches are insensitive to case.
SYMOPT_UNDNAME All symbols are presented in undecorated form.
SYMOPT_DEFERRED_LOADS Symbols are not loaded until a reference is made requiring the symbols be loaded. This is the fastest, most efficient way to use the symbol handler.
SYMOPT_NO_CPP All C++ decorated symbols containing the symbol separator "::" are replaced by "__". This option exists for debuggers that cannot handle parsing real C++ symbol names.

Remarks

The options value can be changed several times while IMAGEHLP is in use by an application. The option change affects all future calls to the symbol handler.

Windows NT: This function is not available under Windows NT 3.51; it was introduced in Windows NT 4.0.