Función PathMatchSpecExW (shlwapi.h)

Coincide con un nombre de archivo de una ruta de acceso con uno o varios patrones de nombre de archivo.

Sintaxis

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

Parámetros

[in] pszFile

Tipo: LPCTSTR

Puntero a una cadena terminada en null que contiene la ruta de acceso desde la que se toma el nombre de archivo que se va a buscar.

[in] pszSpec

Tipo: LPCTSTR

Puntero a una cadena terminada en null que contiene el patrón de nombre de archivo para el que se va a buscar. Puede ser el nombre exacto o puede contener caracteres comodín. Si se especifica exactamente un patrón, establezca la marca PMSF_NORMAL en dwFlags. Si se especifica más de un patrón, separe con punto y coma y establezca la marca PMSF_MULTIPLE .

[in] dwFlags

Tipo: DWORD

Modifica la condición de búsqueda. A continuación se muestran marcas válidas.

PMSF_NORMAL (0x00000000)

El parámetro pszSpec apunta a un único patrón de nombre de archivo que se va a coincidir.

PMSF_MULTIPLE (0x00000001)

El parámetro pszSpec apunta a una lista delimitada por punto y coma de patrones de nombre de archivo que se van a buscar coincidencias.

PMSF_DONT_STRIP_SPACES (0x00010000)

Si se usa PMSF_NORMAL , no omita los espacios iniciales de la cadena a la que apunta pszSpec. Si se usa PMSF_MULTIPLE , no omita los espacios iniciales de cada tipo de archivo contenido en la cadena a la que apunta pszSpec. Esta marca se puede combinar con PMSF_NORMAL y PMSF_MULTIPLE.

Valor devuelto

Tipo: HRESULT

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Un patrón de nombre de archivo especificado en pszSpec coincide con el nombre de archivo encontrado en la cadena a la que apunta pszFile.
S_FALSE	Ningún patrón de nombre de archivo especificado en pszSpec coincide con el nombre de archivo encontrado en la cadena a la que apunta pszFile.

Comentarios

Nota

El encabezado shlwapi.h define PathMatchSpecEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlwapi.h
Library	Shlwapi.lib
Archivo DLL	Shlwapi.dll (versión 7.0 o posterior)

Consulte también

PathMatchSpec