Função PathFindSuffixArrayA (shlwapi.h)

  • Artigo

Determina se um determinado nome de arquivo tem uma de uma lista de sufixos.

Sintaxe

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

Parâmetros

[in] pszPath

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo de comprimento máximo MAX_PATH que contém o nome do arquivo a ser testado. Um caminho completo pode ser usado.

[in] apszSuffix

Tipo: const LPCTSTR*

Uma matriz de ponteiros de cadeia de caracteres iArraySize . Cada cadeia de caracteres apontada é terminada em nulo e contém um sufixo. As cadeias de caracteres podem ter comprimentos variáveis.

[in] iArraySize

Tipo: int

O número de elementos na matriz apontada por apszSuffix.

Retornar valor

Tipo: LPCTSTR

Retorna um ponteiro para uma cadeia de caracteres com o sufixo correspondente se tiver êxito ou NULL se pszPath não terminar com um dos sufixos especificados.

Comentários

Essa função usa uma comparação que diferencia maiúsculas de minúsculas. O sufixo deve corresponder exatamente.

Observação

O cabeçalho shlwapi.h define PathFindSuffixArray como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlwapi.h
Biblioteca Shlwapi.lib
DLL Shlwapi.dll (versão 5.0 ou posterior)