CVssWriter::GetSnapshotDeviceName 메서드(vswriter.h)
GetSnapshotDeviceName 메서드는 지정된 볼륨 또는 파일 공유의 섀도 복사본을 호스트하는 디바이스의 이름을 반환합니다. 이 메서드를 사용하면 기록기에서 섀도 복사본 자동 복구 를 지원할 수 있으며 OnPostSnapshot 메서드를 처리하는 동안에만 호출할 수 있습니다.
구문
HRESULT GetSnapshotDeviceName(
[in] LPCWSTR wszOriginalVolume,
[out] LPCWSTR *ppwszSnapshotDevice
);
매개 변수
[in] wszOriginalVolume
현재 섀도 복사본 집합에 사용되는 데이터를 포함하는 원본 볼륨의 이름 또는 원래 파일 공유의 UNC 경로입니다. 볼륨 이름은 다음 형식 중 하나여야 하며 후행 백슬래시(\)를 포함해야 합니다.
- 탑재된 폴더의 경로(예: Y:\MountX\
- 드라이브 문자(예: D:\
- \\?\Volume{GUID}\ 형식의 볼륨GUID 경로(여기서 GUID 는 볼륨을 식별)
- 원격 파일 공유를 지정하는 UNC 경로(예: \\Clusterx\Share1\
[out] ppwszSnapshotDevice
섀도 복사본의 디바이스 이름에 대한 포인터를 받을 LPCWSTR 의 주소입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
값 | 의미 |
---|---|
|
섀도 복사본 볼륨 이름을 반환했습니다. |
|
매개 변수 값 중 하나가 잘못되었습니다. |
|
PostSnapshot 이벤트 중에 호출이 이루어지지 않았습니다. |
|
wszOriginalVolume 매개 변수는 섀도 복사본 집합의 볼륨 또는 파일 공유 중 하나가 아닙니다. |
설명
Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP 및 Windows Server 2003: 원격 파일 공유는 Windows 8 Windows Server 2012 때까지 지원되지 않습니다.
wszOriginalVolume 매개 변수에 대한 원래 볼륨의 이름을 얻으려면 먼저 CVssWriter::GetCurrentVolumeCount 메서드를 호출하여 섀도 복사본 집합의 볼륨 수를 쿼리합니다. 그런 다음 CVssWriter::GetCurrentVolumeArray 메서드를 호출하여 섀도 복사본 집합에 있는 볼륨의 원래 이름을 열거합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008, Windows Server 2003 SP1 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | vswriter.h(Vss.h, VsWriter.h 포함) |
라이브러리 | VssApi.lib |