This topic has not yet been rated - Rate this topic

IDebugSymbols3::OutputSymbolByOffset method

The OutputSymbolByOffset method looks up a symbol by address and prints the symbol name and other symbol information to the debugger console.

Syntax

HRESULT OutputSymbolByOffset(
  [in]  ULONG OutputControl,
  [in]  ULONG Flags,
  [in]  ULONG64 Offset
);

Parameters

OutputControl [in]

Specifies where to send the output. For possible values, see DEBUG_OUTCTL_XXX.

Flags [in]

Specifies the flags used to determine what information is printed with the symbol.

The following flags can be present:

Bit-flagEffect

DEBUG_OUTSYM_FORCE_OFFSET

Include the location of the symbol.

DEBUG_OUTSYM_SOURCE_LINE

Include the file name and line number of the source file where the symbol is defined.

DEBUG_OUTSYM_ALLOW_DISPLACEMENT

Do not require an exact match for the symbols location.

This allows the Offset parameter to specify any address within the symbol's memory allocation - not just the base address.

 

Offset [in]

Specifies the location in the process's virtual address space of the symbol to be printed.

Return value

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

Return codeDescription
S_OK

The method was successful.

E_NOINTERFACE

No symbol was found at the specified location.

 

Remarks

For more information about symbols, see Symbols.

Requirements

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugSymbols3
GetNameByOffset

 

 

Send comments about this topic to Microsoft

Build date: 4/2/2012

Did you find this helpful?
(1500 characters remaining)