Freigeben über


SymEnumTypesByName-Funktion (dbghelp.h)

Listet alle benutzerdefinierten Typen auf.

Syntax

BOOL IMAGEAPI SymEnumTypesByName(
  [in]           HANDLE                         hProcess,
  [in]           ULONG64                        BaseOfDll,
  [in, optional] PCSTR                          mask,
  [in]           PSYM_ENUMERATESYMBOLS_CALLBACK EnumSymbolsCallback,
  [in]           PVOID                          UserContext
);

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, optional] mask

Ein Wildcardausdruck, der die Namen der zu enumerierten Symbole angibt. Um einen Modulnamen anzugeben, verwenden Sie die ! mod-Syntax .

[in] EnumSymbolsCallback

Ein Zeiger auf eine SymEnumSymbolsProc-Rückruffunktion , die die Symbolinformationen empfängt.

[in] UserContext

Ein benutzerdefinierter Wert, der an die Rückruffunktion übergeben werden soll, oder NULL. Dieser Parameter wird in der Regel von einer Anwendung verwendet, um einen Zeiger an eine Datenstruktur zu übergeben, die Kontextinformationen für die Rückruffunktion bereitstellt.

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

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.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile dbghelp.h
Bibliothek Dbghelp.lib
DLL Dbghelp.dll
Verteilbare Komponente DbgHelp.dll 6.8 oder höher

Weitere Informationen

DbgHelp-Funktionen

SymEnumSymbolsProc