IDebugSymbols3::GetFunctionEntryByOffset-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetFunctionEntryByOffset Methode gibt die Funktionseintragsinformationen für eine Funktion zurück.

Syntax

HRESULT GetFunctionEntryByOffset(
  [in]            ULONG64 Offset,
  [in]            ULONG   Flags,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BufferNeeded
);

Parameter

[in] Offset

Gibt einen Speicherort im virtuellen Adressraum des aktuellen Prozesses der Implementierung der Funktion an. Dies ist der Wert, der im parameter Offset von GetNextSymbolMatch und IDebugSymbolGroup::GetSymbolOffsetzurückgegeben wird, und den Wert des Felds Offset in der DEBUG_SYMBOL_ENTRY Struktur.

[in] Flags

Gibt ein Bit-Flag an, das das Verhalten dieser Methode ändert. Wenn das Bit DEBUG_GETFNENT_RAW_ENTRY_ONLY nicht festgelegt ist, stellt das Modul künstliche Einträge für bekannte Fälle bereit. Wenn dieses Bit festgelegt wird, werden die künstlichen Einträge nicht verwendet.

[out, optional] Buffer

Empfängt die Funktionseintragsinformationen. Wenn der effektive Prozessor ein x86 ist, ist dies die FPO_DATA Struktur für die Funktion. Für alle anderen Architekturen ist dies die IMAGE_FUNCTION_ENTRY Struktur für diese Architektur.

[in] BufferSize

Gibt die Größe des Puffers Puffer-an.

[out, optional] BufferNeeded

Gibt die Größe der Funktionseingabeinformationen an.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich, aber der Puffer war nicht groß genug, um die Funktionseingabeinformationen zu enthalten, und die Informationen wurden so abgeschnitten, dass sie passen.
E_NOINTERFACE	Für die Position Offsetwurden keine Funktionseingabeinformationen gefunden.

Bemerkungen

Die Strukturen FPO_DATA und IMAGE_FUNCTION_ENTRY sind in der Datei "Image Help Library" dokumentiert, die in den Debugtools für Windows in der Datei "DbgHelp.chm" enthalten ist.

Hinweis Die Funktionen in "Bildhilfebibliothek" und "Debughilfebibliothek", dokumentiert in DbgHelp.chm, sollten nicht von einer Erweiterungs- oder Debuggermodulanwendung aufgerufen werden.

Weitere Informationen zu Symbolen finden Sie unter Symbole.