Função PathCchRemoveExtension (pathcch.h)

  • Artigo

Remove a extensão de nome de arquivo de um caminho, se houver.

Essa função é diferente de PathRemoveExtension , pois aceita caminhos com prefixos "\", "\?" e "\?\UNC".

NotaEssa função deve ser usada no lugar de PathRemoveExtension para evitar a possibilidade de um estouro de buffer.

Sintaxe

WINPATHCCHAPI HRESULT PathCchRemoveExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

Parâmetros

[in, out] pszPath

Um ponteiro para a cadeia de caracteres do caminho. Quando essa função retorna com êxito, a cadeia de caracteres contém o caminho com qualquer extensão removida. Se nenhuma extensão for encontrada, a cadeia de caracteres permanecerá inalterada.

[in] cchPath

O tamanho do buffer apontado por pszPath, em caracteres.

Retornar valor

Essa função retornará S_OK se a função tiver sido bem-sucedida, S_FALSE se nenhuma extensão tiver sido encontrada ou um código de erro caso contrário.

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