SymEnumerateSymbols64 Function

Debug Help Library

SymEnumerateSymbols64 Function

Enumerates all the symbols for a specified module.

Note  This function is provided only for compatibility. Applications should use SymEnumSymbols, which is faster and more powerful.

BOOL WINAPI SymEnumerateSymbols64(
  __in          HANDLE hProcess,
  __in          DWORD64 BaseOfDll,
  __in          PSYM_ENUMSYMBOLS_CALLBACK64 EnumSymbolsCallback,
  __in          PVOID UserContext



A handle to the process. This handle must have been previously passed to the SymInitialize function.


The base address of the module for which symbols are to be enumerated.


The callback function that receives the symbol information. For more information, see SymEnumerateSymbolsProc64.


A user-defined value or NULL. This value is passed to the callback function. Typically, this parameter is used by an application to pass a pointer to a data structure that enables the callback function establish some type of context.

Return Value

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.


This function supersedes the SymEnumerateSymbols function. For more information, see Updated Platform Support.

The SymEnumerateSymbols64 function enumerates all the symbols for the specified module. The module information is located by the BaseOfDll parameter. The EnumSymbolsCallback function is called once per symbol and is passed the information for each symbol.

All DbgHelp functions, such as this one, are single threaded. Therefore, calls from more than one thread to this function will likely result in unexpected behavior or memory corruption. To avoid this, you must synchronize all concurrent calls from more than one thread to this function.



Requires DbgHelp.dll 5.1 or later.


Declared in Dbghelp.h.


Use Dbghelp.lib.


Requires Dbghelp.dll.

See Also

DbgHelp FunctionsSymEnumerateSymbolsProc64

Send comments about this topic to Microsoft

Build date: 9/25/2007

© 2007 Microsoft Corporation. All rights reserved.