Freigeben über


SymMatchStringA-Funktion (dbghelp.h)

Vergleicht die angegebene Zeichenfolge mit dem angegebenen Wildcardausdruck.

Syntax

BOOL IMAGEAPI SymMatchStringA(
  [in] PCSTR string,
  [in] PCSTR expression,
  [in] BOOL  fCase
);

Parameter

[in] string

Die Zeichenfolge, z. B. ein Symbolname, der mit dem Ausdruck Parameter verglichen werden soll.

[in] expression

Der Zum Vergleichen mit dem Zeichenfolge Parameter zu verwendenden Wildcardausdruck. Der Wildcardausdruck unterstützt die Aufnahme von * und ? Zeichen. * entspricht einer Zeichenfolge und ? entspricht jedem einzelnen Zeichen.

[in] fCase

Eine Variable, die angibt, ob die Groß-/Kleinschreibung beachtet werden soll.

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.

Anmerkung

Der dbghelp.h-Header definiert SymMatchString als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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
mindestens unterstützte Client- Windows 10 Build 20348
mindestens unterstützte Server- Windows 10 Build 20348
Zielplattform- Fenster
Header- dbghelp.h
Library Dbghelp.lib
DLL- Dbghelp.dll
redistributable DbgHelp.dll 6.2 oder höher

Siehe auch

DbgHelp-Funktionen