SymFunctionTableAccess-Funktion (dbghelp.h)

Artikel
02/29/2024

Ruft den Funktionstabelleneintrag für die angegebene Adresse ab.

Syntax

PVOID IMAGEAPI SymFunctionTableAccess(
  [in] HANDLE hProcess,
  [in] DWORD  AddrBase
);

Parameter

[in] hProcess

Ein Handle für den Prozess, der ursprünglich an die SymInitialize-Funktion übergeben wurde.

[in] AddrBase

Die Basisadresse, für die Funktionstabelleninformationen erforderlich sind.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf den Funktionstabelleneintrag.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Der Typ des zurückgegebenen Zeigers ist spezifisch für das Bild, aus dem Symbole geladen werden.

x86: Wenn das Image für ein x86-System gilt, ist dies ein Zeiger auf eine FPO_DATA-Struktur .

x64: Wenn das Image für ein x64-System gilt, ist dies ein Zeiger auf eine _IMAGE_RUNTIME_FUNCTION_ENTRY-Struktur .

Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.

Diese Funktion ersetzt die SymFunctionTableAccess-Funktion . Weitere Informationen finden Sie unter Aktualisierte Plattformunterstützung. SymFunctionTableAccess ist in Dbghelp.h wie folgt definiert.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymFunctionTableAccess SymFunctionTableAccess64
#else
PVOID
IMAGEAPI
SymFunctionTableAccess(
    __in HANDLE hProcess,
    __in DWORD AddrBase
    );
#endif