SymMatchFileNameW-Funktion (dbghelp.h)
Vergleicht eine Zeichenfolge mit einem Dateinamen und Pfad.
Syntax
BOOL IMAGEAPI SymMatchFileNameW(
[in] PCWSTR FileName,
[in] PCWSTR Match,
[out, optional] PWSTR *FileNameStop,
[out, optional] PWSTR *MatchStop
);
Parameter
[in] FileName
Der Dateiname, der mit dem parameter Match verglichen werden soll.
[in] Match
Die Zeichenfolge, die mit dem FileName-Parameter verglichen werden soll.
[out, optional] FileNameStop
Ein Zeiger auf einen Zeichenfolgenpuffer, der einen Zeiger auf die Position in FileName empfängt, an der der Abgleich beendet wurde. Für eine vollständige Übereinstimmung kann dieser Wert ein Zeichen sein, bevor FileName. Dieser Wert kann auch NULL-sein.
[out, optional] MatchStop
Ein Zeiger auf einen Zeichenfolgenpuffer, der einen Zeiger auf die Position in Match empfängt, an der der Abgleich beendet wurde. Für eine vollständige Übereinstimmung kann dieser Wert ein Zeichen sein, bevor Match. Dieser Wert kann NULL-sein.
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
Da die Übereinstimmungszeichenfolge ein Suffix des vollständigen Dateinamens sein kann, kann diese Funktion verwendet werden, um einen einfachen Dateinamen mit einem vollqualifizierten Dateinamen übereinzugleichen.
Der Abgleich beginnt am Ende beider Zeichenfolgen und geht rückwärts fort. Der Abgleich erfolgt bei der Groß-/Kleinschreibung und entspricht einem umgekehrten Schrägstrich (\) mit einem Schrägstrich (/).
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 SymMatchFileName 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 |
|---|---|
| Zielplattform- | Fenster |
| Header- | dbghelp.h |
| Library | Dbghelp.lib |
| DLL- | Dbghelp.dll |
| redistributable | DbgHelp.dll 5.1 oder höher |