SymGetOmaps Function

Debug Help Library

SymGetOmaps Function

Retrieves the omap tables within a loaded module.

BOOL WINAPI SymGetOmaps(
  __in          HANDLE hProcess,
  __in          ULONG64 BaseOfDll,
  __out         POMAP* OmapTo,
  __out         PDWORD64 cOmapTo,
  __out         POMAP* OmapFrom,
  __out         PDWORD64 cOmapFrom
);

Parameters

hProcess

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

BaseOfDll

The base address of the module.

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.

cOmapTo

The number of entries in the OmapTo array.

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.

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.

Requirements

Redistributable

Requires DbgHelp.dll 6.8 or later.

Header

Declared in Dbghelp.h.

Library

Use Dbghelp.lib.

DLL

Requires Dbghelp.dll.

Send comments about this topic to Microsoft

Build date: 9/25/2007

© 2007 Microsoft Corporation. All rights reserved.