Función PathFindSuffixArrayA (shlwapi.h)

Determina si un nombre de archivo determinado tiene una de una lista de sufijos.

Sintaxis

LPCSTR PathFindSuffixArrayA(
  [in] LPCSTR       pszPath,
  [in] const LPCSTR *apszSuffix,
  [in] int          iArraySize
);

Parámetros

[in] pszPath

Tipo: LPCTSTR de

Puntero a una cadena terminada en null de longitud máxima MAX_PATH que contiene el nombre de archivo que se va a probar. Se puede usar una ruta de acceso completa.

[in] apszSuffix

Tipo: const LPCTSTR*

Matriz de iArraySize punteros de cadena. Cada cadena a la que apunta es terminada en null y contiene un sufijo. Las cadenas pueden ser de longitudes variables.

[in] iArraySize

Tipo: int

Número de elementos de la matriz a los que apunta apszSuffix.

Valor devuelto

Tipo: LPCTSTR de

Devuelve un puntero a una cadena con el sufijo coincidente si se ejecuta correctamente o null si pszPath no termina con uno de los sufijos especificados.

Observaciones

Esta función usa una comparación que distingue mayúsculas de minúsculas. El sufijo debe coincidir exactamente.

Nota

El encabezado shlwapi.h define PathFindSuffixArray 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 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [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 5.0 o posterior)