Função PathCchRemoveBackslashEx (pathcch.h)

Remove a barra invertida à direita do final de uma cadeia de caracteres de caminho.

Essa função difere de PathCchRemoveBackslash , pois pode retornar um ponteiro para a nova extremidade da cadeia de caracteres e relatar o número de caracteres não utilizados restantes no buffer.

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

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

Sintaxe

WINPATHCCHAPI HRESULT PathCchRemoveBackslashEx(
  [in, out]       PWSTR  pszPath,
  [in]            size_t cchPath,
  [out, optional] PWSTR  *ppszEnd,
  [out, optional] size_t *pcchRemaining
);

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 barra invertida à direita removida. Se nenhuma barra invertida à direita tiver sido encontrada, a cadeia de caracteres permanecerá inalterada.

[in] cchPath

O tamanho do buffer apontado por pszPath, em caracteres.

[out, optional] ppszEnd

Um valor que, quando essa função retorna com êxito, recebe o endereço de um ponteiro para o final da nova cadeia de caracteres. Se a cadeia de caracteres for um caminho raiz como "C:", o ponteiro apontará para a barra invertida; caso contrário, o ponteiro aponta para o caractere nulo de terminação da cadeia de caracteres.

[out, optional] pcchRemaining

Um ponteiro para um valor que, quando essa função retorna com êxito, recebe o número de caracteres não utilizados no buffer de destino, incluindo o caractere nulo de terminação. Se a cadeia de caracteres for um caminho raiz como "C:", essa contagem incluirá a barra invertida nessa cadeia de caracteres.

Retornar valor

Essa função retornará S_OK se a função tiver sido bem-sucedida, S_FALSE se a cadeia de caracteres era um caminho raiz ou se nenhuma barra invertida foi encontrada ou um código de erro de outra forma.

Comentários

Essa função não removerá a barra invertida de uma cadeia de caracteres de caminho raiz, como "C:".

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