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