SymSearchW-Funktion (dbghelp.h)

Artikel
11/20/2024

Sucht nach PDB-Symbolen, die den angegebenen Kriterien entsprechen.

Syntax

BOOL IMAGEAPI SymSearchW(
  [in]           HANDLE                          hProcess,
  [in]           ULONG64                         BaseOfDll,
  [in, optional] DWORD                           Index,
  [in, optional] DWORD                           SymTag,
  [in, optional] PCWSTR                          Mask,
  [in, optional] DWORD64                         Address,
  [in]           PSYM_ENUMERATESYMBOLS_CALLBACKW EnumSymbolsCallback,
  [in, optional] PVOID                           UserContext,
  [in]           DWORD                           Options
);

Parameter

[in] hProcess

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

[in] BaseOfDll

Die Basisadresse des Moduls. Wenn dieser Wert null ist und Mask ein Ausrufezeichen (!)enthält, sieht die Funktion über Module hinweg. Wenn dieser Wert null ist und Mask- kein Ausrufezeichen enthält, verwendet die Funktion den Bereich, der durch die SymSetContext-funktion festgelegt wurde.

[in, optional] Index

Ein eindeutiger Wert für das Symbol.

[in, optional] SymTag

Die PDB-Klassifizierung. Diese Werte werden in Dbghelp.h im SymTagEnum Enumerationstyp definiert. Beschreibungen finden Sie in der PDB-Dokumentation.

[in, optional] Mask

Ein Wildcardausdruck, der die Namen der symbole angibt, die aufgezählt werden sollen. Um einen Modulnamen anzugeben, verwenden Sie die !mod Syntax.

[in, optional] Address

Die Adresse des Symbols.

[in] EnumSymbolsCallback

Eine SymEnumSymbolsProc Rückruffunktion, die die Symbolinformationen empfängt.

[in, optional] UserContext

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

[in] Options

Die Optionen, die das Verhalten dieser Funktion steuern.

Wert	Bedeutung
SYMSEARCH_ALLITEMS 0x08	Fügen Sie alle Symbole und andere Daten in die PDB-Dateien ein. DbgHelp 6.6 und früher: Dieser Wert wird nicht unterstützt.
SYMSEARCH_GLOBALSONLY 0x04	Suchen Sie nur nach globalen Symbolen.
SYMSEARCH_MASKOBJS 0x01	Nur für die interne Verwendung.
SYMSEARCH_RECURSE 0x02	Rekursieren Sie von oben nach allen Symbolen.

Rückgabewert

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

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

Bemerkungen

Alle DbgHelp-Funktionen, z. B. diese, sind single threaded. Daher führen Aufrufe von mehr als einem Thread zu dieser Funktion wahrscheinlich zu unerwartetem Verhalten oder Speicherbeschädigung. Um dies zu vermeiden, müssen Sie alle gleichzeitigen Aufrufe von mehr als einem Thread mit dieser Funktion synchronisieren.

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

Anmerkung

Der dbghelp.h-Header definiert SymSearch als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	dbghelp.h
Library	Dbghelp.lib
DLL-	Dbghelp.dll
redistributable	DbgHelp.dll 6.2 oder höher

Siehe auch

DbgHelp-Funktionen

SymEnumSymbolsProc

Freigeben über