Função PathCchRenameExtension (pathcch.h)

Substitui a extensão de um nome de arquivo no final de uma cadeia de caracteres de caminho por uma nova extensão. Se a cadeia de caracteres de caminho não terminar com uma extensão, a nova extensão será adicionada.

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

Sintaxe

WINPATHCCHAPI HRESULT PathCchRenameExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath,
  [in]      PCWSTR pszExt
);

Parâmetros

[in, out] pszPath

Um ponteiro para a cadeia de caracteres de caminho. Quando essa função retorna com êxito, esse valor aponta para a mesma cadeia de caracteres, mas com a extensão renomeada ou adicionada.

[in] cchPath

O tamanho do buffer apontado por pszPath, em caracteres.

[in] pszExt

Um ponteiro para a nova cadeia de caracteres de extensão. O caractere '.' à esquerda é opcional. No caso de uma cadeia de caracteres vazia (""), qualquer extensão existente na cadeia de caracteres de caminho é removida.

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