The SymRegisterCallback function lets an application register a callback function for use by the symbol handler.
BOOL SymRegisterCallback(
| IN DWORD UserOptions, | |
| IN HANDLE hProcess, | |
| IN PSYMBOL_REGISTERED_CALLBACK CallbackFunction, | |
| IN PVOID UserContext | |
| ); |
Parameters
UserOptions
hProcess
The process handle that was originally passed to SymInitialize.
CallbackFunction
A pointer to a callback function.
UserContext
A user-defined value or NULL. This value is simply passed through to the callback function. Normally, this parameter is used by an application to pass a pointer to a data structure that lets the callback function establish some type of context.
Return Values
If the function succeeds, the return value is TRUE.
If the function fails, then the return value is FALSE. To retrieve extended error information, call GetLastError.
Remarks
The SymRegisterCallback function lets an application register a callback function for use by the symbol handler. The symbol handler calls the registered callback function when there is status or progress information for the application.
Windows NT: This function is not available under Windows NT 3.51; it was introduced in Windows NT 4.0.