PathMatchSpecExW-Funktion (shlwapi.h)
Vergleicht einen Dateinamen aus einem Pfad mit einem oder mehreren Dateinamenmustern.
Syntax
LWSTDAPI PathMatchSpecExW(
[in] LPCWSTR pszFile,
[in] LPCWSTR pszSpec,
[in] DWORD dwFlags
);
Parameter
[in] pszFile
Typ: LPCTSTR
Ein Zeiger auf eine NULL-Zeichenfolge, die den Pfad enthält, aus dem der zu übereinstimmende Dateiname genommen wird.
[in] pszSpec
Typ: LPCTSTR
Ein Zeiger auf eine NULL-Zeichenfolge, die das Dateinamenmuster enthält, nach dem gesucht werden soll. Dies kann der genaue Name sein oder ein Feldhalterzeichen enthalten. Wenn genau ein Muster angegeben ist, legen Sie das PMSF_NORMAL-Flag in dwFlags fest. Wenn mehrere Muster angegeben sind, trennen Sie diese durch Semikolons, und legen Sie das PMSF_MULTIPLE-Flag fest.
[in] dwFlags
Art: DWORD
Ändert die Suchbedingung. Im Folgenden sind gültige Flags aufgeführt.
PMSF_NORMAL (0x00000000)
Der pszSpec-Parameter verweist auf ein einzelnes Dateinamenmuster, das abgeglichen werden soll.
PMSF_MULTIPLE (0x00000001)
Der pszSpec-Parameter verweist auf eine durch Semikolon getrennte Liste von Dateinamenmustern, die abgeglichen werden sollen.
PMSF_DONT_STRIP_SPACES (0x00010000)
Wenn PMSF_NORMAL verwendet wird, ignorieren Sie nicht führende Leerzeichen in der Zeichenfolge, auf die von pszSpec verwiesen wird. Wenn PMSF_MULTIPLE verwendet wird, ignorieren Sie nicht führende Leerzeichen in jedem Dateityp, der in der Zeichenfolge enthalten ist, auf die von pszSpec verwiesen wird. Dieses Flag kann mit PMSF_NORMAL und PMSF_MULTIPLE kombiniert werden.
Rückgabewert
Typ: HRESULT
Gibt einen der folgenden Werte zurück.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Ein in pszSpec angegebenes Dateinamenmuster entsprach dem Dateinamen in der Zeichenfolge, auf die von pszFile verwiesen wird. |
|
Kein in pszSpec angegebenes Dateinamenmuster entsprach dem Dateinamen in der Zeichenfolge, auf die von pszFile verwiesen wird. |
Hinweise
Hinweis
Der shlwapi.h-Header definiert PathMatchSpecEx 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 nicht codierungsneutralem Code 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 |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shlwapi.h |
Bibliothek | Shlwapi.lib |
DLL | Shlwapi.dll (Version 7.0 oder höher) |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Feedback senden und anzeigen für