PathCchStripToRoot 함수(pathcch.h)
루트 정보를 제외한 경로의 모든 파일 및 디렉터리 요소를 제거합니다.
이 함수는 "\", "\?" 및 "\?\UNC" 접두사를 사용하여 경로를 허용한다는 점에서 PathStripToRoot 와 다릅니다.
참고 버퍼 오버런 가능성을 방지하기 위해 PathStripToRoot 대신 이 함수를 사용해야 합니다.
구문
WINPATHCCHAPI HRESULT PathCchStripToRoot(
[in, out] PWSTR pszPath,
[in] size_t cchPath
);
매개 변수
[in, out] pszPath
경로 문자열에 대한 포인터입니다. 이 함수가 성공적으로 반환되면 이 문자열에는 해당 경로에서 가져온 루트 정보만 포함됩니다.
[in] cchPath
pszPath가 가리키는 버퍼의 크기(문자)입니다.
반환 값
이 함수는 경로가 잘린 경우 경로가 이미 루트이거나 HRESULT 오류 코드인지 S_FALSE S_OK 반환합니다.
설명
이 함수의 효과에 대한 몇 가지 예는 다음과 같습니다.
초기 문자열 | 최종 문자열 |
---|---|
"C:\path1\path2\file" | "C:\" |
"\\path1\path2\path3" | "\\path1\path2" |
"\path1" | "\" |
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | pathcch.h |
라이브러리 | Pathcch.lib |