IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths 메서드(vsbackup.h)

IVsBackupComponents::AddToSnapshotSet 메서드에 전달할 수 있도록 로컬 볼륨 경로 또는 UNC 공유 경로를 정규화합니다.

구문

HRESULT GetRootAndLogicalPrefixPaths(
  [in]           VSS_PWSZ pwszFilePath,
  [out]          VSS_PWSZ *ppwszRootPath,
  [out]          VSS_PWSZ *ppwszLogicalPrefix,
  [in, optional] BOOL     bNormalizeFQDNforRootPath
);

매개 변수

[in] pwszFilePath

정규화할 경로입니다.

[out] ppwszRootPath

IVssBackupComponents::AddToSnapshotSet 메서드에 전달되어야 하는 루트 경로를 받습니다.

[out] ppwszLogicalPrefix

pwszFilePath가 로컬 경로인 경우 이 매개 변수는 볼륨 GUID 이름을 받습니다. UNC 경로인 경우 이 매개 변수는 완전히 평가된 공유 경로를 받습니다.

[in, optional] bNormalizeFQDNforRootPath

pwszFilePath가 UNC 공유 경로인 경우 서버 이름 부분은

• 호스트 이름
• 정규화된 도메인 이름
• IP 주소

이 매개 변수는 ppwszRootPath 매개 변수에 반환되는 정규화된 루트 경로의 서버 이름 부분에 호스트 이름 형식 또는 정규화된 도메인 이름 형식을 사용할지 여부를 지정합니다.

이 매개 변수가 FALSE이면 간단한 호스트 이름 형식이 사용됩니다.

이 매개 변수의 기본값은 FALSE입니다.

이 매개 변수가 TRUE이면 정규화된 도메인 이름이 사용됩니다.

호스트 이름이 여러 도메인 접미사에 있을 수 있는 배포에서 이 매개 변수는 TRUE여야 합니다.

반환 값

다음은 이 메서드에 대한 유효한 반환 코드입니다.

반환 코드	Description
S_OK	경로 정보를 반환했습니다.
E_OUTOFMEMORY	호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.

설명

이 메서드는 로컬 볼륨 경로 또는 UNC 공유 경로를 정규화하고 루트 경로 및 논리 접두사 경로로 구분합니다. 그런 다음 루트 경로를 IVssBackupComponents::AddToSnapshotSet 메서드에 전달할 수 있습니다.

pwszFilePath가 로컬 볼륨 경로인 경우 루트 경로는 볼륨 탑재 지점과 유사합니다. 이 경우 루트 및 논리 접두사 경로는 각각 GetVolumePathName 및 GetVolumeNameForVolumeMountPoint의 결과에 매핑됩니다.

pwszFilePath가 UNC 공유 경로인 경우 루트 및 논리 접두사 경로는 각각 파일 공유의 루트 경로와 완전히 평가된 실제 공유 경로(DFS 및 클러스터 배포를 고려)에 매핑됩니다.

동일한 섀도 복사본 집합 만들기 작업에 대해 이 메서드를 두 번 이상 호출하는 경우 bNormalizeFQDNforRootPath 를 모든 호출에 대해 동일한 값으로 설정해야 합니다. 정규화된 도메인 이름 형식 및 호스트 이름 형식은 동일한 섀도 복사본 집합에서 혼합할 수 없습니다.

요구 사항

지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	vsbackup.h(VsBackup.h, Vss.h, VsWriter.h 포함)

추가 정보

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponentsEx4