Função PathCchAddBackslash (pathcch.h)

  • Artigo

Adiciona uma barra invertida ao final de uma cadeia de caracteres para criar a sintaxe correta para um caminho. Se o caminho de origem já tiver uma barra invertida à direita, nenhuma barra invertida será adicionada.

Essa função difere de PathCchAddBackslashEx , na qual você está restrito a um caminho final de comprimento MAX_PATH.

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

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

Sintaxe

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

Parâmetros

[in, out] pszPath

Um ponteiro para a cadeia de caracteres de caminho. Quando essa função retorna com êxito, o buffer contém a cadeia de caracteres com a barra invertida acrescentada. Esse valor não deve ser NULL.

[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 a cadeia de caracteres de caminho já terminar em uma barra invertida ou um código de erro de outra forma.

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

Confira também

PathCchAddBackslashEx