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
S_OK
Ein in pszSpec angegebenes Dateinamenmuster entsprach dem Dateinamen in der Zeichenfolge, auf die von pszFile verwiesen wird.
S_FALSE
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

PathMatchSpec