IDebugSymbols3::GetFunctionEntryByOffset-Methode (dbgeng.h)

Artikel
02/26/2024

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 Offset-Parameter von GetNextSymbolMatch und IDebugSymbolGroup::GetSymbolOffset zurückgegeben wird, und der Wert des Felds Offset in der DEBUG_SYMBOL_ENTRY-Struktur .

[in] Flags

Gibt ein Bitflag an, das das Verhalten dieser Methode ändert. Wenn das Bit DEBUG_GETFNENT_RAW_ENTRY_ONLY nicht festgelegt ist, stellt die Engine künstliche Einträge für bekannte Fälle bereit. Wenn dieses Bit festgelegt ist, 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 Pufferpuffers an.

[out, optional] BufferNeeded

Gibt die Größe der Funktionseintragsinformationen 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 Funktionseintragsinformationen zu enthalten, sodass die Informationen so abgeschnitten wurden, dass sie passen.
E_NOINTERFACE	Für den Standort Offset wurden keine Funktionseintragsinformationen gefunden.

Hinweise

Die Strukturen FPO_DATA und IMAGE_FUNCTION_ENTRY sind in der Datei "DbgHelp.chm" in den Debugtools für Windows enthalten.

Hinweis Die Funktionen in "Image Help Library" und "Debug Help Library", die in DbgHelp.chm dokumentiert sind, sollten von keiner Erweiterungs- oder Debugger-Engine-Anwendung aufgerufen werden.

Weitere Informationen zu Symbolen finden Sie unter Symbole.