SymGetTypeFromName-Funktion (dbghelp.h)

Artikel
02/29/2024

Ruft einen Typindex für den angegebenen Typnamen ab.

Syntax

BOOL IMAGEAPI SymGetTypeFromName(
  [in]      HANDLE       hProcess,
  [in]      ULONG64      BaseOfDll,
  [in]      PCSTR        Name,
  [in, out] PSYMBOL_INFO Symbol
);

Parameter

[in] hProcess

Ein Handle für einen Prozess. Dieses Handle muss zuvor an die SymInitialize-Funktion übergeben worden sein.

[in] BaseOfDll

Die Basisadresse des Moduls.

[in] Name

Der Name des Typs.

[in, out] Symbol

Ein Zeiger auf eine SYMBOL_INFO-Struktur . Das TypeIndex-Element enthält den Typindex.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Um Informationen zum Typ abzurufen, übergeben Sie den Typindex an die SymGetTypeInfo-Funktion .

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.

Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.