PathCchAppend 함수(pathcch.h)

한 경로를 다른 경로의 끝에 추가합니다.

이 함수는 길이가 MAX_PATH 최종 경로로 제한된다는 점에서 PathCchAppendEx 와 다릅니다.

이 함수는 "\", "\?" 및 "\?\UNC" 접두사를 사용하여 경로를 허용한다는 점에서 PathAppend 와 다릅니다.

참고 버퍼 오버런 가능성을 방지하기 위해 PathAppend 대신 이 함수 또는 PathCchAppendEx를 사용해야 합니다.

구문

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

[in, out] pszPath

항목에 원래 경로가 포함된 버퍼에 대한 포인터입니다. 이 함수가 성공적으로 반환되면 버퍼에는 원래 경로와 추가된 경로가 포함됩니다.

[in] cchPath

pszPath가 가리키는 버퍼의 크기(문자)입니다.

[in, optional] pszMore

pszPath가 가리키는 경로의 끝에 추가할 경로에 대한 포인터입니다. "\?" 시퀀스로 시작하는 UNC 경로 및 경로가 허용되고 정규화된 경로로 인식됩니다. 이러한 경로는 pszPath 가 가리키는 문자열을 추가하지 않고 바꿉니다.

이 함수가 성공하면 S_OK 반환합니다. 그렇지 않으면 다음을 포함하여 HRESULT 코드를 반환합니다.

반환 코드	설명
E_INVALIDARG	pszPath 또는 pszMore가 NULL이거나, cchPath가 0이거나, cchPath가 PATHCCH_MAX_CCH보다 큽니다.
PATHCCH_E_FILENAME_TOO_LONG	결과 문자열이 PATHCCH_MAX_CCH 초과합니다.
E_OUTOFMEMORY	함수가 필요한 크기의 버퍼를 할당할 수 없습니다.

이 함수는 아직 없는 경우 두 문자열 사이에 백슬래시를 삽입합니다.