Edit

Share via

SymGetOmaps function (dbghelp.h)

  • Article

Retrieves the omap tables within a loaded module.

Syntax

BOOL IMAGEAPI SymGetOmaps(
  [in]  HANDLE   hProcess,
  [in]  DWORD64  BaseOfDll,
  [out] POMAP    *OmapTo,
  [out] PDWORD64 cOmapTo,
  [out] POMAP    *OmapFrom,
  [out] PDWORD64 cOmapFrom
);

Parameters

[in] hProcess

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

[in] BaseOfDll

The base address of the module.

[out] OmapTo

An array of address map entries to the new image layout taken from the original layout. For details on the map entries, see the OMAP structure.

[out] cOmapTo

The number of entries in the OmapTo array.

[out] OmapFrom

An array of address map entries from the new image layout to the original layout (as described by the debug symbols). For details on the map entries, see the OMAP structure.

[out] cOmapFrom

The number of entries in the OmapFrom array.

Return value

If the function succeeds, the return value is TRUE.

If the function fails (the omap is not found), the return value is FALSE. To retrieve extended error information, call GetLastError.

Remarks

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

Requirement Value
Target Platform Windows
Header dbghelp.h
Library Dbghelp.lib
DLL Dbghelp.dll
Redistributable DbgHelp.dll 6.8 or later

See also

OMAP