SymRegisterCallback

The SymRegisterCallback function lets an application register a callback function for use by the symbol handler.

BOOL SymRegisterCallback(
  IN HANDLE hProcess,                               
  IN PSYMBOL_REGISTERED_CALLBACK CallbackFunction,  
  IN PVOID UserContext                              
);
 

Parameters

hProcess

Handle to the process that was originally passed to the SymInitialize function.

CallbackFunction

Pointer to a callback function. For more information, see SymbolRegisteredCallback.

UserContext

A user-defined value or NULL. This value is simply passed 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, 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.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in imagehlp.h.
  Import Library: Use imagehlp.lib.

See Also

PE Image Helper (ImageHlp) Overview, Symbol Handler, SymbolRegisteredCallback, SymInitialize