Função PathCchFindExtension (pathcch.h)

Pesquisa um caminho para encontrar sua extensão de nome de arquivo, como ".exe" ou ".ini". Essa função não procura uma extensão específica; ele procura a presença de qualquer extensão.

Essa função difere de PathFindExtension , pois aceita caminhos com prefixos "\", "\?" e "\?\UNC".

Nota Essa função deve ser usada no lugar de PathFindExtension para evitar a possibilidade de um estouro de buffer.

Sintaxe

WINPATHCCHAPI HRESULT PathCchFindExtension(
  [in]  PCWSTR pszPath,
  [in]  size_t cchPath,
  [out] PCWSTR *ppszExt
);

Parâmetros

[in] pszPath

Um ponteiro para o caminho a ser pesquisado.

[in] cchPath

O tamanho do buffer apontado por pszPath em caracteres , incluindo o terminador nulo.

[out] ppszExt

O endereço de um ponteiro que, quando essa função retorna com êxito, aponta para o caractere "." que precede a extensão no pszPath. Se nenhuma extensão for encontrada, ela apontará para o caractere nulo de terminação da cadeia de caracteres.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	pathcch.h
Biblioteca	Pathcch.lib