PathCchAddBackslashEx 함수(pathcch.h)

문자열 끝에 백슬래시를 추가하여 경로에 대한 올바른 구문을 만듭니다. 원본 경로에 이미 후행 백슬래시가 있는 경우 백슬래시가 추가되지 않습니다.

이 함수는 문자열의 새 끝에 대한 포인터를 반환하고 버퍼에 남아 있는 사용되지 않는 문자 수를 보고할 수 있다는 점에서 PathCchAddBackslash 와 다릅니다.

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

참고 버퍼 오버런 가능성을 방지하려면 PathAddBackslash 대신 이 함수 또는 PathCchAddBackslash를 사용해야 합니다.

구문

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

매개 변수

[in, out] pszPath

경로 문자열에 대한 포인터입니다. 이 함수가 성공적으로 반환되면 버퍼에 추가된 백슬래시가 있는 문자열이 포함됩니다. 이 값은 NULL이 아니어야 합니다.

[in] cchPath

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

[out, optional] ppszEnd

이 함수가 성공적으로 반환될 때 문자열 끝에 있는 종료 null 문자에 대한 포인터의 주소를 수신하는 값입니다.

[out, optional] pcchRemaining

이 함수가 성공적으로 반환될 때 종료 null 문자를 포함하여 대상 버퍼에서 사용되지 않는 문자 수로 설정된 값에 대한 포인터입니다.

반환 값

이 함수는 함수가 성공하면 S_OK반환하고, 경로 문자열이 이미 백슬래시로 끝나는지 S_FALSE, 그렇지 않으면 오류 코드를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	pathcch.h
라이브러리	Pathcch.lib

추가 정보

PathCchAddBackslash