IDebugSymbols3::GetSymbolEntriesByOffset method

The GetSymbolEntriesByOffset method returns the symbols which are located at a specified address.

Syntax


HRESULT GetSymbolEntriesByOffset(
  [in]            ULONG64              Offset,
  [in]            ULONG                Flags,
  [out, optional] PDEBUG_MODULE_AND_ID Ids,
  [out, optional] PULONG64             Displacements,
  [in]            ULONG                IdsCount,
  [out, optional] PULONG               Entries
);

Parameters

Offset [in]

Specifies a location in the process's memory address space within the desired symbol's range. Not all symbols have a known range, so, for best results, use the base address of the symbol.

Flags [in]

Set to zero.

Ids [out, optional]

Receives the symbols. This is an array of IdsCount entries of type DEBUG_MODULE_AND_ID. If Ids is NULL, this information is not returned.

Displacements [out, optional]

Receives the differences between the base addresses of the found symbols and the given address according to the symbol's range.

IdsCount [in]

Specifies the number of entries that the arrays Ids and Displacements can hold.

Entries [out, optional]

Receives the number of symbols located at Offset. If Entries is NULL, this information is not returned.

Return value

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

Return codeDescription
S_OK

The method was successful.

 

Remarks

For more information about symbols, see Symbols.

Requirements

Target platform

Desktop

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugSymbols3
GetSymbolEntriesByName

 

 

Send comments about this topic to Microsoft

Show: