IDebugSymbols3::GetSymbolEntriesByOffset method (dbgeng.h)

Article
02/22/2024

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

[in] 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.

[in] Flags

Set to zero.

[out, optional] 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.

[out, optional] Displacements

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

[in] IdsCount

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

[out, optional] Entries

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 code	Description
S_OK	The method was successful.

Remarks

For more information about symbols, see Symbols.

Requirements

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

Share via