Compartir a través de

Función PathMatchSpecExA (shlwapi.h)

  • Artículo

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

Sintaxis

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

Parámetros

[in] pszFile

Tipo: LPCTSTR de

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

[in] pszSpec

Tipo: LPCTSTR de

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

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

Observaciones

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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de shlwapi.h
biblioteca de Shlwapi.lib
DLL de Shlwapi.dll (versión 7.0 o posterior)

Consulte también

PathMatchSpec