PathMatchSpecExW-Funktion (shlwapi.h)

Artikel
11/20/2024

Entspricht einem 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 mit Null beendete Zeichenfolge, die den Pfad enthält, aus dem der zuzuordnende Dateiname übernommen wird.

[in] pszSpec

Typ: LPCTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die das Dateinamenmuster enthält, nach dem gesucht werden soll. Dies kann der genaue Name sein, oder er kann Wildcardzeichen enthalten. Wenn genau ein Muster angegeben ist, legen Sie das PMSF_NORMAL Flag in dwFlagsfest. Wenn mehrere Muster angegeben werden, trennen Sie sie durch Semikolons, und legen Sie das PMSF_MULTIPLE Flag fest.

[in] dwFlags

Typ: DWORD-

Ändert die Suchbedingung. Es folgen gültige Flags.

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 Semikolons getrennte Liste mit Dateinamenmustern, die abgeglichen werden sollen.

PMSF_DONT_STRIP_SPACES (0x00010000)

Wenn PMSF_NORMAL verwendet wird, ignorieren Sie führende Leerzeichen in der Zeichenfolge, auf die durch pszSpecverwiesen wird. Wenn PMSF_MULTIPLE verwendet wird, ignorieren Sie führende Leerzeichen nicht in jedem Dateityp, der in der Zeichenfolge enthalten ist, auf die pszSpecverweist. Diese Kennzeichnung kann mit PMSF_NORMAL und PMSF_MULTIPLEkombiniert werden.

Rückgabewert

Typ: HRESULT-

Gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
S_OK	Ein dateiname pattern specified in pszSpec matched the file name found in the string point to by pszFile.
S_FALSE	In pszSpec wurde kein Dateinamenmuster angegeben, das in der Zeichenfolge gefunden wurde, auf die pszFileverweist.

Bemerkungen

Anmerkung

Der Header "shlwapi.h" 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 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 Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 7.0 oder höher)

Siehe auch

PathMatchSpec-

Freigeben über