SymGetModuleInfo64 Function

Retrieves the module information of the specified module.

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

BOOL WINAPI SymGetModuleInfo64(
  __in          HANDLE hProcess,
  __in          DWORD64 dwAddr,
  __out         PIMAGEHLP_MODULE64 ModuleInfo
);

Parameters

hProcess

A handle to the process that was originally passed to the SymInitialize function.

dwAddr

The virtual address that is contained in one of the modules loaded by the SymLoadModule64 function

ModuleInfo

A pointer to an IMAGEHLP_MODULE64 structure. The SizeOfStruct member must be set to the size of the IMAGEHLP_MODULE64 structure. An invalid value will result in an error.

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.

Remarks

The module table is searched for a module that contains the dwAddr. The module is located based on the load address and size of each module. If a valid module is found, the ModuleInfo parameter is filled with the information about the module.

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.

Requirements

See Also

DbgHelp FunctionsIMAGEHLP_MODULE64
SymInitialize
SymLoadModule64

Send comments about this topic to Microsoft

Build date: 9/25/2007