Edit

IDebugSymbols3::GetSymbolModule method (dbgeng.h)

  • Article

The GetSymbolModule method returns the base address of module which contains the specified symbol.

Syntax

HRESULT GetSymbolModule(
  [in]  PCSTR    Symbol,
  [out] PULONG64 Base
);

Parameters

[in] Symbol

Specifies the name of the symbol to look up. See the Remarks section for details of the syntax of this name.

[out] Base

Receives the location in the target's memory address space of the base of the module. For more information, see Modules.

Return value

This method may also return error values. See Return Values for more details.

Return code Description
S_OK
 The method was successful.
E_NOINTERFACE
 The symbol or module could not be found.

Remarks

The string Symbol must contain an exclamation point ( ! ). If Symbol is a module-qualified symbol name (for example, mymodules!main) or if the module name is omitted (for example, !main), the engine will search for this symbol and return the module in which it is found. If Symbol contains just a module name (for example, mymodule!) the engine returns the first module with this module name.

For more information about symbols, see Symbols.

Requirements

Requirement Value
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)