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.