다음을 통해 공유

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

  • 아티클

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

구문

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

매개 변수

[in] SnapshotSetId

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

[in] SnapshotId

만들 그림자 복사본의 식별자입니다.

[in] pwszSharePath

파일 공유 경로입니다.

[in] lNewContext

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

[in] ProviderId

공급자 ID입니다.

반환 값

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

값 의미
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 8.1 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 vsprov.h
라이브러리 VssApi.lib

추가 정보

IVssFileShareSnapshotProvider