IVssBackupComponents 클래스(vsbackup.h)

IVssBackupComponents 인터페이스는 요청자가 파일 상태 대한 작성자를 폴링하고 백업/복원 작업을 실행하는 데 사용됩니다.

애플리케이션은 CreateVssBackupComponents를 호출하여 IVssBackupComponents 인터페이스의 instance 가져옵니다.

IVssBackupComponents 개체는 단일 백업, 복원 또는 쿼리 작업에만 사용할 수 있습니다.

백업, 복원 또는 쿼리 작업이 성공적으로 완료되었거나 명시적으로 종료된 후 요청자는 IVssBackupComponents::Release를 호출하여 IVssBackupComponents 개체를 해제해야 합니다. IVssBackupComponents 개체를 다시 사용할 수 없습니다. 예를 들어 쿼리 작업에 이미 사용한 것과 동일한 IVssBackupComponents 개체를 사용하여 백업 또는 복원 작업을 수행할 수 없습니다.

상속

IVssBackupComponents 인터페이스는IUnknown 인터페이스에서 상속됩니다. IVssBackupComponents 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IVssBackupComponents 클래스에는 이러한 메서드가 있습니다.

IVssBackupComponents::AbortBackup AbortBackup 메서드는 VSS에 백업 작업이 종료되었음을 알 수 있습니다.
IVssBackupComponents::AddAlternativeLocationMapping AddAlternativeLocationMapping 메서드는 요청자가 지정된 구성 요소에 있는 파일 집합의 모든 멤버를 복원하는 데 대체 위치 매핑을 사용했음을 나타내는 데 사용됩니다.
IVssBackupComponents::AddComponent 백업 집합에 명시적으로 추가하는 데 사용됩니다.
IVssBackupComponents::AddNewTarget AddNewTarget 메서드는 복원 작업 중에 요청자가 백업 애플리케이션이 파일을 새 위치로 복원할 계획임을 나타내는 데 사용됩니다.
IVssBackupComponents::AddRestoreSubcomponent 백업을 위해 선택 불가능으로 표시되었지만 복원을 위해 선택 가능한 것으로 표시된 구성 요소 집합의 하위 구성 요소 멤버가 복원될 것임을 나타냅니다.
IVssBackupComponents::AddToSnapshotSet AddToSnapshotSet 메서드는 원래 볼륨 또는 원래 원격 파일 공유를 섀도 복사본 집합에 추가합니다.
IVssBackupComponents::BackupComplete BackupComplete 메서드를 사용하면 VSS가 BackupComplete 이벤트를 생성합니다. 이 이벤트는 백업 프로세스가 완료되었음을 기록기에 알릴 수 있습니다.
IVssBackupComponents::BreakSnapshotSet BreakSnapshotSet 메서드를 사용하면 VSS에서 섀도 복사본 집합이 "잊혀지게" 됩니다.
IVssBackupComponents::D eleteSnapshots DeleteSnapshots 메서드는 하나 이상의 섀도 복사본 또는 섀도 복사본 집합을 삭제합니다.
IVssBackupComponents::D isableWriterClasses DisableWriterClasses 메서드는 특정 작성기 클래스가 이벤트를 수신하지 못하도록 합니다.
IVssBackupComponents::D isableWriterInstances DisableWriterInstances 메서드는 지정된 작성기 instance 또는 인스턴스를 사용하지 않도록 설정합니다.
IVssBackupComponents::D oSnapshotSet 이 집합의 모든 섀도 복사본을 동시에 커밋합니다.
IVssBackupComponents::EnableWriterClasses EnableWriterClasses 메서드를 사용하면 지정된 작성기가 모든 이벤트를 수신할 수 있습니다.
IVssBackupComponents::ExposeSnapshot ExposeSnapshot 메서드는 섀도 복사본을 드라이브 문자, 탑재된 폴더 또는 파일 공유로 노출합니다.
IVssBackupComponents::FreeWriterMetadata FreeWriterMetadata 메서드는 IVssBackupComponents::GatherWriterMetadata가 호출되었을 때 할당된 시스템 리소스를 해제합니다.
IVssBackupComponents::FreeWriterStatus FreeWriterStatus 메서드는 IVssBackupComponents::GatherWriterStatus를 호출하는 동안 할당된 시스템 리소스를 해제합니다.
IVssBackupComponents::GatherWriterMetadata GatherWriterMetadata 메서드는 각 작성기에게 수집한 메타데이터를 보내라는 메시지를 표시합니다. 메서드는 기록기와 통신하는 Identify 이벤트를 생성합니다.
IVssBackupComponents::GatherWriterStatus GatherWriterStatus 메서드는 각 작성기에게 상태 메시지를 보내라는 메시지를 표시합니다.
IVssBackupComponents::GetSnapshotProperties GetSnapshotProperties 메서드는 지정된 섀도 복사본의 속성을 가져옵니다.
IVssBackupComponents::GetWriterComponents GetWriterComponents 메서드는 요청자의 백업 구성 요소 문서에 저장된 지정된 작성기의 해당 구성 요소에 대한 정보를 반환하는 데 사용됩니다.
IVssBackupComponents::GetWriterComponentsCount GetWriterComponentsCount 메서드는 구성 요소가 요청자의 백업 구성 요소 문서에 추가된 기록기 수를 반환합니다.
IVssBackupComponents::GetWriterMetadata GetWriterMetadata 메서드는 시스템에서 실행되는 특정 기록기에 대한 메타데이터를 반환합니다.
IVssBackupComponents::GetWriterMetadataCount GetWriterMetadataCount 메서드는 메타데이터가 있는 기록기 수를 반환합니다.
IVssBackupComponents::GetWriterStatus GetWriterStatus 메서드는 지정된 작성기의 상태 반환합니다.
IVssBackupComponents::GetWriterStatusCount GetWriterStatusCount 메서드는 상태 있는 기록기 수를 반환합니다.
IVssBackupComponents::ImportSnapshots 다른 컴퓨터에서 전송된 섀도 복사본을 가져옵니다.
IVssBackupComponents::InitializeForBackup InitializeForBackup 메서드는 백업 준비 시 백업 구성 요소 메타데이터를 초기화합니다.
IVssBackupComponents::InitializeForRestore InitializeForRestore 메서드는 복원 작업을 준비하기 위해 IVssBackupComponents 인터페이스를 초기화합니다.
IVssBackupComponents::IsVolumeSupported IsVolumeSupported 메서드는 지정된 공급자가 지정된 볼륨 또는 원격 파일 공유에서 섀도 복사본을 지원하는지 여부를 결정합니다.
IVssBackupComponents::P ostRestore PostRestore 메서드를 사용하면 VSS가 PostRestore 이벤트를 생성하여 기록기에 현재 복원 작업이 완료되었음을 알릴 수 있습니다.
IVssBackupComponents::P repareForBackup PrepareForBackup 메서드를 사용하면 VSS가 PrepareForBackup 이벤트를 생성하여 기록기가 예정된 백업 작업을 준비하도록 알릴 수 있습니다. 이렇게 하면 요청자의 백업 구성 요소 문서를 작성자가 사용할 수 있습니다.
IVssBackupComponents::P reRestore PreRestore 메서드를 사용하면 VSS에서 PreRestore 이벤트를 생성하여 기록기가 예정된 복원 작업을 준비하도록 알릴 수 있습니다.
IVssBackupComponents::Query Query 메서드는 시스템의 공급자 및/또는 현재 컨텍스트에 있는 시스템의 완료된 섀도 복사본을 쿼리합니다. 메서드는 백업 작업 중에만 호출할 수 있습니다.
IVssBackupComponents::QueryRevertStatus 되돌리기 작업의 상태 확인하는 데 사용할 수 있는 IVssAsync 인터페이스 포인터를 반환합니다. (IVssBackupComponents.QueryRevertStatus)
IVssBackupComponents::RevertToSnapshot 볼륨을 이전 섀도 복사본으로 되돌려 줍니다. (IVssBackupComponents.RevertToSnapshot)
IVssBackupComponents::SaveAsXML SaveAsXML 메서드는 요청자의 상태 정보가 포함된 Backup 구성 요소 문서를 지정된 문자열에 저장합니다. 백업 구성 요소 문서가 포함된 이 XML 문서는 항상 백업 작업의 일부로 안전하게 저장해야 합니다.
IVssBackupComponents::SetAdditionalRestores SetAdditionalRestores 메서드는 증분 또는 차등 복원 작업 중에 요청자가 지정된 구성 요소를 완전히 검색하기 위해 추가 복원 작업이 필요하다는 것을 기록기에 나타내는 데 사용됩니다.
IVssBackupComponents::SetBackupOptions SetBackupOptions 메서드는 구성 요소에 대한 프라이빗 또는 기록기 종속 백업 매개 변수의 문자열을 설정합니다.
IVssBackupComponents::SetBackupState SetBackupState 메서드는 백업 작업에 대한 전체 구성을 정의합니다.
IVssBackupComponents::SetBackupSucceeded SetBackupSucceeded 메서드는 특정 작성기의 지정된 구성 요소 백업이 성공했는지 여부를 나타냅니다.
IVssBackupComponents::SetContext SetContext 메서드는 후속 섀도 복사본 관련 작업에 대한 컨텍스트를 설정합니다.
IVssBackupComponents::SetFileRestoreStatus SetFileRestoreStatus 메서드는 일부 파일, 전체 또는 파일이 성공적으로 복원되었는지 여부를 나타냅니다.
IVssBackupComponents::SetPreviousBackupStamp SetPreviousBackupStamp 메서드는 차등 또는 증분 백업 작업의 기반이 되는 이전 백업 작업의 백업 스탬프를 설정합니다.
IVssBackupComponents::SetRangesFilePath SetRangesFilePath 메서드는 부분 파일 작업에 범위 파일이 필요하고 해당 파일이 원래 파일이 아닌 다른 위치로 복원된 경우에 사용됩니다.
IVssBackupComponents::SetRestoreOptions SetRestoreOptions 메서드는 기록기 구성 요소에 대한 프라이빗 또는 기록기 종속 복원 매개 변수의 문자열을 설정합니다.
IVssBackupComponents::SetRestoreState SetRestoreState 메서드는 복원 작업에 대한 전체 구성을 정의합니다.
IVssBackupComponents::SetSelectedForRestore SetSelectedForRestore 메서드는 지정된 선택 가능한 구성 요소가 복원을 위해 선택되었는지 여부를 나타냅니다.
IVssBackupComponents::StartSnapshotSet StartSnapshotSet 메서드는 빈 새 섀도 복사본 집합을 만듭니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	vsbackup.h(VsBackup.h, Vss.h, VsWriter.h 포함)