IDebugSymbols3::GetSymbolEntriesByOffset-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetSymbolEntriesByOffset-Methode gibt die Symbole zurück, die sich an einer angegebenen Adresse befinden.

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
);

Parameter

[in] Offset

Gibt einen Speicherort im Speicheradressraum des Prozesses innerhalb des Bereichs des gewünschten Symbols an. Nicht alle Symbole weisen einen bekannten Bereich auf, daher verwenden Sie für optimale Ergebnisse die Basisadresse des Symbols.

[in] Flags

Auf NULL festlegen.

[out, optional] Ids

Empfängt die Symbole. Dies ist ein Array von IdsCount-Einträgen vom Typ DEBUG_MODULE_AND_ID. Wenn IDsNULL ist, werden diese Informationen nicht zurückgegeben.

[out, optional] Displacements

Empfängt die Unterschiede zwischen den Basisadressen der gefundenen Symbole und der angegebenen Adresse entsprechend dem Bereich des Symbols.

[in] IdsCount

Gibt die Anzahl der Einträge an, die die Arrays IDs und Verschiebungen enthalten können.

[out, optional] Entries

Empfängt die Anzahl der Symbole, die sich unter Offset befinden. Wenn Entriesden Wert NULL aufweist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Weitere Informationen zu Symbolen finden Sie unter Symbole.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (dbgeng.h einschließen)

Weitere Informationen

GetSymbolEntriesByName

IDebugSymbols3

Freigeben über