IVssBackupComponents::ImportSnapshots 메서드(vsbackup.h)

아티클
08/27/2023

ImportSnapshots 메서드는 다른 컴퓨터에서 전송된 섀도 복사본을 가져옵니다.

참고 이 방법은 Windows Server 운영 체제 및 볼륨 섀도 복사본 서비스 하드웨어 공급자에서만 지원됩니다.

구문

HRESULT ImportSnapshots(
  [out] IVssAsync **ppAsync
);

매개 변수

[out] ppAsync

가져온 섀도 복사본 상태 데이터를 포함하는 IVssAsync 개체에 대한 이중 간접 포인터입니다.

반환 값

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

값	의미
S_OK	IVssAsync 인터페이스의 instance 대한 포인터를 반환했습니다. pHrResult 매개 변수에 반환된 오류 코드는 IVssAsync::QueryStatus에 대한 참조 페이지를 참조하세요.
E_ACCESSDENIED	호출자에게 충분한 백업 권한이 없거나 관리자가 아닙니다.
E_INVALIDARG	ppAsync 매개 변수는 유효한 포인터를 가리키지 않습니다. 즉, NULL입니다.
E_OUTOFMEMORY	호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_BAD_STATE	백업 구성 요소 개체가 초기화되지 않았거나, 복원 작업 중에 이 메서드가 호출되었거나, 이 메서드가 올바른 시퀀스 내에서 호출되지 않았습니다.
VSS_E_UNEXPECTED	예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008 R2 및 Windows 7까지 지원되지 않습니다. E_UNEXPECTED 대신 사용됩니다.

설명

한 번에 하나의 섀도 복사본만 가져올 수 있습니다.

요청자는 섀도 복사 가져오기 작업을 직렬화해야 합니다.

호출자는 IVssAsync 인터페이스를 해제할 책임이 있습니다.

섀도 복사본을 가져오는 방법에 대한 자세한 내용은 전송 가능한 섀도 복사 볼륨 가져오기를 참조하세요.

클러스터에서 전송 가능한 섀도 복사본: 클러스터에서 전송 가능한 섀도 복사본을 사용하는 방법에 대한 자세한 내용은 전송 가능한 섀도 복사 볼륨을 사용하여 빠른 복구를 참조하세요. 원래 볼륨이 클러스터 내에 탑재되는 한 전송 가능한 섀도 복사본을 클러스터 외부에서 가져와야 합니다.

참고 섀도 복사본 가져오기가 실패하면 볼륨 섀도 복사본 서비스에서 LUN을 자체적으로 클린 않습니다. 요청자는 LUN 정리를 시작해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2008, Windows Server 2003 SP1, Windows Server 2003 Datacenter, Windows Server 2003 Enterprise [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	vsbackup.h(VsBackup.h, Vss.h, VsWriter.h 포함)
라이브러리	VssApi.lib