IVssBackupComponents 類別 (vsbackup.h)

要求者會使用 IVssBackupComponents 介面來輪詢有關檔案狀態的寫入器,以及執行備份/還原作業。

應用程式藉由呼叫CreateVssBackupComponents 來取得 IVssBackupComponents 介面的實例。

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 方法會停用指定的寫入器實例或實例。
IVssBackupComponents::D oSnapshotSet

同時認可此集合中的所有陰影複製。
IVssBackupComponents::EnableWriterClasses

EnableWriterClasses 方法可讓指定的寫入器接收所有事件。
IVssBackupComponents::ExposeSnapshot

ExposeSnapshot 方法會將陰影複製公開為磁碟機號、掛接的資料夾或檔案共用。
IVssBackupComponents::FreeWriterMetadata

FreeWriterMetadata 方法會釋放呼叫 IVssBackupComponents::GatherWriterMetadata 時所配置的系統資源。
IVssBackupComponents::FreeWriterStatus

FreeWriterStatus 方法會釋放呼叫 IVssBackupComponents::GatherWriterStatus 期間配置的系統資源。
IVssBackupComponents::GatherWriterMetadata

CollectWriterMetadata 方法會提示每個寫入器傳送所收集的中繼資料。 方法會產生識別事件,以與寫入器通訊。
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 方法會將包含要求者狀態資訊的備份元件檔儲存至指定的字串。 此 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)