PathMatchSpecExA-Funktion (shlwapi.h)

  • Artikel

Vergleicht einen Dateinamen aus einem Pfad mit mindestens einem Dateinamenmuster.

Syntax

LWSTDAPI PathMatchSpecExA(
  [in] LPCSTR pszFile,
  [in] LPCSTR pszSpec,
  [in] DWORD  dwFlags
);

Parameter

[in] pszFile

Typ: LPCTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Pfad enthält, aus dem der abzugleichende Dateiname genommen wird.

[in] pszSpec

Typ: LPCTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die das Dateinamenmuster enthält, nach dem gesucht werden soll. Dies kann der genaue Name sein, oder es kann Wildcardzeichen 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 flag PMSF_MULTIPLE 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 keine führenden Leerzeichen in der Zeichenfolge, auf die von pszSpec verwiesen wird. Wenn PMSF_MULTIPLE verwendet wird, ignorieren Sie keine führenden 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 entspricht 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 pszFile verweist.

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 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

   
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