Share via

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

  • 아티클

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

구문

HRESULT BeginPrepareSnapshot(
  [in] VSS_ID   SnapshotSetId,
  [in] VSS_ID   SnapshotId,
  [in] VSS_PWSZ pwszVolumeName,
  [in] LONG     lNewContext
);

매개 변수

[in] SnapshotSetId

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

[in] SnapshotId

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

[in] pwszVolumeName

볼륨 이름을 포함하는 Null로 끝나는 와이드 문자열입니다. 이름은 다음 형식 중 하나여야 하며 후행 백슬래시(\)를 포함해야 합니다.

  • 탑재된 폴더의 경로(예: Y:\MountX\
  • 드라이브 문자(예: D:\
  • \\?\Volume{GUID}\ 형식의 볼륨GUID 경로(여기서 GUID 는 볼륨을 식별)

[in] lNewContext

섀도 복사본 집합의 컨텍스트입니다. 이 컨텍스트는 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES 값의 비트 마스크로 구성됩니다.

반환 값

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

값 의미
S_OK
 섀도 복사본을 만들었습니다.
E_ACCESSDENIED
 호출자에게 충분한 백업 권한이 없거나 관리자가 아닙니다.
E_INVALIDARG
 매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY
 호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_OBJECT_NOT_FOUND
 지정된 볼륨을 찾을 수 없습니다.
VSS_E_PROVIDER_VETO
 공급자 오류입니다. 공급자가 이벤트 로그에 오류를 기록했습니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
VSS_E_UNSUPPORTED_CONTEXT
 지정된 컨텍스트는 지원되지 않습니다.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
 공급자는 지정된 볼륨을 지원하지 않습니다.
VSS_E_UNEXPECTED
 예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008 R2 및 Windows 7까지 지원되지 않습니다. E_UNEXPECTED 대신 사용됩니다.

요구 사항

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

추가 정보

IVssSoftwareSnapshotProvider