다음을 통해 공유

PathAllocCombine 함수(pathcch.h)

  • 아티클

두 경로 조각을 단일 경로로 연결합니다. 또한 이 함수는 상대 경로 요소를 정식화하여 "." 및 ".."와 같은 경로 요소를 대체합니다.

이 함수는 힙의 결과를 반환한다는 점에서 PathCchCombine 및 PathCchCombineEx 와 다릅니다. 즉, 호출자가 반환된 문자열의 크기를 선언할 필요가 없으며 스택 사용을 줄입니다.

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

참고 이 함수인 PathCchCombine 또는 PathCchCombineEx는 PathCombine 대신 사용해야 합니다.
<

구문

WINPATHCCHAPI HRESULT PathAllocCombine(
  [in]  PCWSTR pszPathIn,
  [in]  PCWSTR pszMore,
  [in]  ULONG  dwFlags,
  [out] PWSTR  *ppszPathOut
);

매개 변수

[in] pszPathIn

첫 번째 경로 문자열에 대한 포인터입니다.

[in] pszMore

두 번째 경로 문자열에 대한 포인터입니다. 이 경로가 단일 백슬래시로 시작하는 경우 pszPathIn이 가리키는 경로의 루트와만 결합됩니다. 이 경로가 정규화된 경우 다른 경로와 결합되지 않고 출력 버퍼에 직접 복사됩니다.

[in] dwFlags

다음 플래그 중 하나 이상:

값 의미
PATHCCH_NONE
0x0000000
 MAX_PATH 보다 긴 \\?\ 경로(즉, 긴 경로)의 생성을 허용하지 않습니다.
PATHCCH_ALLOW_LONG_PATHS
0x00000001
 MAX_PATH 보다 긴 \\?\ 경로의 생성을 허용 합니다.
PATHCCH_FORCE_ENABLE_LONG_NAME_PROCESS
0x00000002
 API가 프로세스의 긴 이름 사용 상태와 관계없이 호출자를 긴 경로 사용으로 처리하도록 합니다. 이 옵션은 PATHCCH_ALLOW_LONG_PATHS 지정된 경우에만 사용할 수 있으며 PATHCCH_FORCE_DISABLE_LONG_NAME_PROCESS 사용할 수 없습니다.

참고 이 값은 Windows 10 버전 1703부터 사용할 수 있습니다.
PATHCCH_FORCE_DISABLE_LONG_NAME_PROCESS
0x00000004
 API가 프로세스의 긴 이름 사용 상태와 관계없이 호출자를 긴 경로를 사용하지 않도록 처리하도록 합니다. 이 옵션은 PATHCCH_ALLOW_LONG_PATHS 지정한 경우에만 사용할 수 있으며 PATHCCH_FORCE_ENABLE_LONG_NAME_PROCESS 사용할 수 없습니다.

참고 이 값은 Windows 10 버전 1703부터 사용할 수 있습니다.
PATHCCH_DO_NOT_NORMALIZE_SEGMENTS
0x00000008
 후행 점과 공백 제거를 포함하는 경로 세그먼트의 정규화를 사용하지 않도록 설정합니다. 이렇게 하면 win32 경로 정규화가 차단되는 경로에 액세스할 수 있습니다.

참고 이 값은 Windows 10 버전 1703부터 사용할 수 있습니다.
PATHCCH_ENSURE_IS_EXTENDED_LENGTH_PATH
0x00000010
 입력 경로가 확장된 DOS 디바이스 경로 양식(\\?\ 접두사 포함)으로 변환합니다(해당 형식이 아직 없는 경우). 이렇게 하면 Win32 정규화 규칙(후행 점 및 공백을 제거할 수 있는) 및 경로 길이 제한으로 인해 주소를 지정할 수 없는 경로에 액세스할 수 있습니다. 이 옵션은 PATHCCH_DO_NOT_NORMALIZE_SEGMENTS 동일한 동작을 의미합니다.

참고 이 값은 Windows 10 버전 1703부터 사용할 수 있습니다.
PATHCCH_ENSURE_TRAILING_SLASH
0x00000020
 경로를 결합하거나 정규화할 때 후행 백슬래시가 있는지 확인합니다.

참고 이 값은 Windows 10 버전 1703부터 사용할 수 있습니다.

[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

추가 정보

PathCchCombine

PathCchCombineEx