PathAllocCanonicalize 함수(pathcch.h)
경로 문자열을 정식 형식으로 변환합니다.
이 함수는 힙의 결과를 반환한다는 점에서 PathCchCanonicalize 및 PathCchCanonicalizeEx 와 다릅니다. 즉, 호출자는 반환된 문자열의 크기를 선언할 필요가 없으며 스택 사용을 줄입니다.
이 함수는 "\", "\?" 및 "\?\UNC" 접두사를 사용하여 경로를 허용한다는 점에서 PathCanonicalize 와 다릅니다.
구문
WINPATHCCHAPI HRESULT PathAllocCanonicalize(
[in] PCWSTR pszPathIn,
[in] ULONG dwFlags,
[out] PWSTR *ppszPathOut
);
매개 변수
[in] pszPathIn
원래 문자열을 포함하는 버퍼에 대한 포인터입니다. 이 값은 NULL일 수 없습니다.
[in] dwFlags
다음 플래그 중 하나 이상:
[out] ppszPathOut
이 함수가 성공적으로 반환될 때 정식화된 경로 문자열을 수신하는 버퍼에 대한 포인터의 주소입니다. 더 이상 필요하지 않은 경우 LocalFree 함수를 호출하여 이 리소스를 해제하는 것은 호출자의 책임입니다. 이 값은 NULL일 수 없습니다.
반환 값
이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
이 함수는 다음과 같은 대체 경로 양식을 지원합니다.
- \\?\
- \\?\\Unc\
- \\?\Volume{guid}\
이 함수는 슬래시(/)를 슬래시(\)로 변환하지 않습니다. 신뢰할 수 없는 입력을 사용하면 이 함수 자체를 사용하여 경로를 하위 경로 또는 ID의 다른 경로와 비교할 수 있는 형식으로 변환할 수 없습니다. 이 기능이 필요한 호출자는 이 함수를 사용하기 전에 슬래시로 앞으로 변환해야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | pathcch.h |
라이브러리 | Pathcch.lib |
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기