Share via

IVssHardwareSnapshotProvider::BeginPrepareSnapshot 메서드(vsprov.h)

  • 아티클

섀도 복사본 집합에 추가되는 각 섀도 복사본에 대해 BeginPrepareSnapshot 메서드가 호출됩니다.

참고 하드웨어 공급자는 Windows Server 운영 체제에서만 지원됩니다.
 

구문

HRESULT BeginPrepareSnapshot(
  [in]      VSS_ID              SnapshotSetId,
  [in]      VSS_ID              SnapshotId,
  [in]      LONG                lContext,
  [in]      LONG                lLunCount,
  [in]      VSS_PWSZ            *rgDeviceNames,
  [in, out] VDS_LUN_INFORMATION *rgLunInformation
);

매개 변수

[in] SnapshotSetId

섀도 복사본 집합 식별자입니다.

[in] SnapshotId

만들 섀도 복사본의 식별자입니다.

[in] lContext

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES 열거된 현재 섀도 복사본 집합에 대한 섀도 복사본 컨텍스트입니다.

[in] lLunCount

이 섀도 복사본 볼륨에 기여하는 LUN 수입니다.

[in] rgDeviceNames

문자열에 대한 lLunCount 포인터 배열에 대한 포인터로, 섀도 복사할 LUN의 이름을 포함하는 각 문자열입니다.

[in, out] rgLunInformation

이 섀도 복사본 볼륨에 기여하는 각 LUN에 대해 하나씩 lLunCountVDS_LUN_INFORMATION 구조체의 배열에 대한 포인터입니다.

반환 값

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

반환 코드/값 설명
S_OK
0x00000000L
 작업이 성공적으로 완료되었습니다.
E_OUTOFMEMORY
0x8007000EL
 메모리 부족 또는 기타 시스템 리소스.
E_INVALIDARG
0x80070057L
 매개 변수 값 중 하나가 잘못되었습니다.
VSS_E_MAXIMUM_NUMBER_OF_VOLUMES_REACHED
0x80042312L
 공급자가 지원할 수 있는 최대 볼륨 수에 도달했습니다.
VSS_E_NESTED_VOLUME_LIMIT
 지정된 볼륨이 너무 깊게 중첩되어 VSS 작업에 참여할 수 없습니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 반환 코드는 지원되지 않습니다.
VSS_E_PROVIDER_VETO
0x80042306L
 예기치 않은 공급자 오류가 발생했습니다. 공급자는 사용자에게 문제를 resolve 방법에 대한 정보를 제공하는 이벤트를 애플리케이션 이벤트 로그에 보고해야 합니다.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
0x8004230EL
 공급자는 이 볼륨을 지원하지 않습니다.
VSS_E_UNSUPPORTED_CONTEXT
0x8004231BL
 lContext에서 지정한 컨텍스트는 지원되지 않습니다.

설명

이 메서드는 다른 VHD 내에 중첩된 VHD(가상 하드 디스크)에 대해 호출할 수 없습니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: VHD는 지원되지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 vsprov.h

추가 정보

IVssHardwareSnapshotProvider

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES