PathMatchSpecExW, fonction (shlwapi.h)

Article
11/20/2024

Correspond à un nom de fichier à partir d’un chemin d’accès à un ou plusieurs modèles de nom de fichier.

Syntaxe

LWSTDAPI PathMatchSpecExW(
  [in] LPCWSTR pszFile,
  [in] LPCWSTR pszSpec,
  [in] DWORD   dwFlags
);

Paramètres

[in] pszFile

Type : LPCTSTR

Pointeur vers une chaîne terminée par null qui contient le chemin d’accès à partir duquel le nom de fichier à mettre en correspondance est pris.

[in] pszSpec

Type : LPCTSTR

Pointeur vers une chaîne terminée par null qui contient le modèle de nom de fichier pour lequel effectuer une recherche. Il peut s’agir du nom exact, ou il peut contenir des caractères génériques. Si exactement un modèle est spécifié, définissez l’indicateur PMSF_NORMAL dans dwFlags. Si plusieurs modèles sont spécifiés, séparez-les par des points-virgules et définissez l’indicateur PMSF_MULTIPLE.

[in] dwFlags

Type : DWORD

Modifie la condition de recherche. Les indicateurs suivants sont valides.

PMSF_NORMAL (0x00000000)

Le paramètre pszSpec pointe vers un modèle de nom de fichier unique à mettre en correspondance.

PMSF_MULTIPLE (0x00000001)

Le paramètre pszSpec pointe vers une liste délimitée par des points-virgules des modèles de nom de fichier à mettre en correspondance.

PMSF_DONT_STRIP_SPACES (0x00010000)

Si PMSF_NORMAL est utilisé, n’ignorez pas les espaces de début dans la chaîne pointée par pszSpec. Si PMSF_MULTIPLE est utilisé, n’ignorez pas les espaces de début dans chaque type de fichier contenu dans la chaîne pointée par pszSpec. Cet indicateur peut être combiné avec PMSF_NORMAL et PMSF_MULTIPLE.

Valeur de retour

Type : HRESULT

Retourne l’une des valeurs suivantes.

Retourner le code	Description
S_OK	Modèle de nom de fichier spécifié dans pszSpec correspond au nom de fichier trouvé dans la chaîne pointée par pszFile.
S_FALSE	Aucun modèle de nom de fichier spécifié dans pszSpec correspond au nom de fichier trouvé dans la chaîne pointée par pszFile.

Remarques

Note

L’en-tête shlwapi.h définit PathMatchSpecEx comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlwapi.h
bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 7.0 ou ultérieure)

Voir aussi

PathMatchSpec

Partager via