IDebugSymbols3::GetSourceEntriesByOffset method (dbgeng.h)

Article
02/22/2024

Queries symbol information and returns locations in the target's memory by using an offset.

Syntax

HRESULT GetSourceEntriesByOffset(
  [in]            ULONG64                    Offset,
  [in]            ULONG                      Flags,
  [out]           PDEBUG_SYMBOL_SOURCE_ENTRY Entries,
  [in]            ULONG                      EntriesCount,
  [out, optional] PULONG                     EntriesAvail
);

Parameters

[in] Offset

The offset of the entry.

[in] Flags

A bit-set that contains options that affect the behavior of this method.

[out] Entries

A pointer to a returned entry as a DEBUG_SYMBOL_SOURCE_ENTRY structure.

[in] EntriesCount

The number of entries.

[out, optional] EntriesAvail

A pointer to the number of entries available.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method can return multiple results for a source lookup. This allows for all possible results to be returned.

Requirements

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