Função PathCchAppend (pathcch.h)

Acrescenta um caminho ao final de outro.

Essa função difere de PathCchAppendEx porque você está restrito a um caminho final de comprimento MAX_PATH.

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

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

Sintaxe

WINPATHCCHAPI HRESULT PathCchAppend(
  [in, out]      PWSTR  pszPath,
  [in]           size_t cchPath,
  [in, optional] PCWSTR pszMore
);

Parâmetros

[in, out] pszPath

Um ponteiro para um buffer que, na entrada, contém o caminho original. Quando essa função retorna com êxito, o buffer contém o caminho original mais o caminho acrescentado.

[in] cchPath

O tamanho do buffer apontado por pszPath, em caracteres.

[in, optional] pszMore

Um ponteiro para o caminho a ser acrescentado ao final do caminho apontado por pszPath. Caminhos e caminhos UNC que começam com a sequência "\?" são aceitos e reconhecidos como caminhos totalmente qualificados. Esses caminhos substituem a cadeia de caracteres apontada por pszPath em vez de serem acrescentados a ela.

Retornar valor

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

Código de retorno	Descrição
E_INVALIDARG	PszPath ou pszMore é NULL, cchPath é 0 ou cchPath é maior que PATHCCH_MAX_CCH.
PATHCCH_E_FILENAME_TOO_LONG	A cadeia de caracteres resultante excederia PATHCCH_MAX_CCH.
E_OUTOFMEMORY	A função não pôde alocar um buffer do tamanho necessário.

Comentários

Essa função insere uma barra invertida entre as duas cadeias de caracteres, se uma ainda não estiver presente.

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

PathCchAppendEx