PathCchRemoveFileSpec 함수(pathcch.h)

해당 요소가 파일 이름이든 디렉터리 이름이든 관계없이 경로 문자열의 마지막 요소를 제거합니다. 요소의 선행 백슬래시도 제거됩니다.

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

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

구문

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

매개 변수

[in, out] pszPath

정규화된 경로 문자열에 대한 포인터입니다. 이 함수가 성공적으로 반환되면 문자열의 마지막 요소와 선행 백슬래시가 제거됩니다. 이 함수는 "C:"와 같은 루트 경로에 영향을 주지 않습니다. 루트 경로의 경우 경로 문자열은 변경되지 않고 반환됩니다. 경로 문자열이 후행 백슬래시로 끝나는 경우 해당 백슬래시만 제거됩니다.

[in] cchPath

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

반환 값

이 함수는 함수가 성공하면 S_OK 반환하고, 제거할 항목이 없는 경우 S_FALSE , 그렇지 않으면 오류 코드를 반환합니다.

설명

다음 표에서는 이 함수가 경로 문자열 선택에 미치는 영향을 보여 줍니다.

원래 문자열	반환된 문자열
"C:\path1"	"C:\"
"C:\path1\path2"	"C:\path1"
"C:\path1\"	"C:\path1"
"\\path1\path2\path3"	"\\path1\path2"
"\path1"	"\"

요구 사항

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