SymEnumModulesCallback

The SymEnumModulesCallback function is an application-defined callback function used with the SymEnumerateModules function. It is called once for each enumerated module, and receives the module information.

The PSYM_ENUMMODULES_CALLBACK type defines a pointer to this callback function. SymEnumModulesCallback is a placeholder for the application-defined function name.

BOOL CALLBACK SymEnumModulesCallback(
  LPSTR ModuleName, 
  ULONG BaseOfDll,  
  PVOID UserContext 
);
 

Parameters

ModuleName

Pointer to a null-terminated string that specifies the name of the module.

BaseOfDll

Specifies the base address where the module is loaded into memory.

UserContext

A user-defined value specified in SymEnumerateModules, or NULL. Typically, 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 return value is TRUE, the enumeration will continue.

If the return value is FALSE, the enumeration will stop.

Remarks

The calling application is called once per module until all modules are enumerated, or until the enumeration callback function returns FALSE.

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: User-defined.

See Also

PE Image Helper (ImageHlp) Overview, Symbol Handler, SymEnumerateModules