IVssFileShareSnapshotProvider::D eleteSnapshots 메서드(vsprov.h)

특정 스냅샷 또는 지정된 스냅샷 집합의 모든 스냅샷을 삭제합니다.

구문

HRESULT DeleteSnapshots(
  [in]  VSS_ID          SourceObjectId,
  [in]  VSS_OBJECT_TYPE eSourceObjectType,
  [in]  BOOL            bForceDelete,
  [out] LONG            *plDeletedSnapshots,
  [out] VSS_ID          *pNondeletedSnapshotID
);

매개 변수

[in] SourceObjectId

삭제할 섀도 복사본 또는 섀도 복사본 집합의 식별자입니다.

[in] eSourceObjectType

삭제할 개체의 형식입니다. 이 매개 변수의 값은 VSS_OBJECT_SNAPSHOT 또는 VSS_OBJECT_SNAPSHOT_SET.

[in] bForceDelete

이 매개 변수의 값이 TRUE이면 공급자는 섀도 복사본 집합에서 섀도 복사본 또는 섀도 복사본을 삭제하기 위해 가능한 모든 작업을 수행합니다. FALSE이면 추가 작업이 수행되지 않습니다.

[out] plDeletedSnapshots

삭제된 섀도 복사본 수를 수신하는 변수에 대한 포인터입니다.

[out] pNondeletedSnapshotID

오류가 발생하면 이 매개 변수는 삭제할 수 없는 첫 번째 섀도 복사본의 식별자에 대한 포인터를 받습니다. 그렇지 않으면 GUID_NULL 가리킵니다.

반환 값

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

값	의미
S_OK	섀도 복사본이 성공적으로 삭제되었습니다.
E_ACCESSDENIED	호출자에게 충분한 백업 권한이 없거나 관리자가 아닙니다.
E_INVALIDARG	매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY	호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_OBJECT_NOT_FOUND	지정한 섀도 복사본을 찾을 수 없습니다.
VSS_E_PROVIDER_VETO	공급자 오류입니다. 공급자가 이벤트 로그에 오류를 기록했습니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.

설명

VSS 코디네이터는 이 메서드를 스냅샷 자동 릴리스 프로세스의 일부로 호출합니다. 메서드는 요청자 기반 삭제 작업에 대한 응답으로도 호출됩니다.

요구 사항

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

추가 정보

IVssFileShareSnapshotProvider