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