Share via

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 의 주소입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값 의미
S_OK
 섀도 복사본 볼륨 이름을 반환했습니다.
E_INVALIDARG
 매개 변수 값 중 하나가 잘못되었습니다.
VSS_E_BAD_STATE
 PostSnapshot 이벤트 중에 호출이 이루어지지 않았습니다.
VSS_E_OBJECT_NOT_FOUND
 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