PathCchRemoveBackslashEx 함수(pathcch.h)

경로 문자열의 끝에서 후행 백슬래시를 제거합니다.

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

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

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

구문

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

매개 변수

[in, out] pszPath

경로 문자열에 대한 포인터입니다. 이 함수가 성공적으로 반환되면 문자열에는 후행 백슬래시가 제거된 경로가 포함됩니다. 후행 백슬래시를 찾을 수 없으면 문자열이 변경되지 않습니다.

[in] cchPath

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

[out, optional] ppszEnd

이 함수가 성공적으로 반환될 때 새 문자열의 끝에 대한 포인터의 주소를 수신하는 값입니다. 문자열이 "C:"와 같은 루트 경로인 경우 포인터는 백슬래시를 가리킵니다. 그렇지 않으면 포인터가 문자열의 종료 null 문자를 가리킵니다.

[out, optional] pcchRemaining

이 함수가 성공적으로 반환될 때 종료되는 null 문자를 포함하여 대상 버퍼에서 사용되지 않는 문자 수를 수신하는 값에 대한 포인터입니다. 문자열이 "C:"와 같은 루트 경로인 경우 이 개수에는 해당 문자열의 백슬래시가 포함됩니다.

반환 값

이 함수는 함수가 성공하면 S_OK 반환하고, 문자열 이 루트 경로인지, 백슬래시를 찾을 수 없는지 또는 오류 코드가 없는지 S_FALSE 반환합니다.

설명

이 함수는 "C:"와 같은 루트 경로 문자열에서 백슬래시를 제거하지 않습니다.

요구 사항

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