GetSymbolEntriesByOffset

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

HRESULT
  IDebugSymbols3::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

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

Set to zero.

Ids

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

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

IdsCount

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

Entries

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

Return Value

S_OK

The method was successful.

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

Interface Version

GetSymbolEntriesByOffset is available in IDebugSymbols3 and later versions.

Comments

For more information about symbols, see Symbols.

Requirements

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

GetSymbolEntriesByName