CVssWriter 類別 (vswriter.h)

CVssWriter 類別是抽象基類，可定義寫入器與 VSS 和其他寫入器同步處理其狀態的介面。

每個寫入器都必須具現化衍生自 CVssWriter 的物件。

衍生自 CVssWriter 的對象必須為所有 CVssWriter 的純虛擬方法提供實作。

寫入器可以覆寫一或所有 CVssWriter 的虛擬方法。

若要參與 VSS，寫入器必須先呼叫 CVssWriter：：Initialize ，然後呼叫 CVssWriter：：Subscribe。

寫入器會呼叫 CVssWriter：：Unsubscribe 終止其參與。

CVssWriter 基類負責傳遞至事件處理程式的介面生命週期。 其中包括下列項目：

• 傳遞至下列專案的 IVssWriterComponents 介面實例： CVssWriter：：OnPrepareBackup

  CVssWriter：：OnBackupComplete

  CVssWriter：：OnPreRestore

  CVssWriter：：OnPostRestore

  CVssWriter：：OnPostSnapshot

• 傳遞至 CVssWriter：：OnIdentify 之 IVssCreateWriterMetadata 介面的實例。

CVssWriter 具有下列類型的成員：

方法

CVssWriter 類別具有這些方法。

CVssWriter：：~CVssWriter ~CVssWriter 是 CVssWriter 類別物件的解構函式。
CVssWriter：：AreComponentsSelected IsComponentsSelected 方法會指出要求者是否在元件模式下執行，並支援選取要備份或備份整個磁碟區的個別元件。
CVssWriter：：CVssWriter CVssWriter 是 CVssWriter 類別物件的建構函式。
CVssWriter：：GetBackupType GetBackupType 方法會指出要執行的備份類型。
CVssWriter：：GetContext GetContext 資訊會傳回任何進行中或可能陰影複製的目前內容。
CVssWriter：：GetCurrentLevel GetCurrentLevel 方法會傳回目前的應用層級。
CVssWriter：：GetCurrentSnapshotSetId GetCurrentSnapshotSetId 方法會傳回陰影複製集的唯一標識符。
CVssWriter：：GetCurrentVolumeArray GetCurrentVolumeArray 方法會傳回原始磁碟區的名稱，以及屬於陰影複製集之原始遠端檔案共用的 UNC 路徑，做為 Null 終止寬字元字串的陣列。Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008、Windows XP 和 Windows Server 2003：在 Windows 8 和 Windows Server 2012 之前，不支持遠端檔案共用。
CVssWriter：：GetCurrentVolumeCount GetCurrentVolumeCount 方法會傳回陰影複製集中的磁碟區數目。
CVssWriter：：GetRestoreType GetRestoreType 方法會傳回寫入器參與的還原類型。
CVssWriter：：GetSnapshotDeviceName GetSnapshotDeviceName 方法會傳回裝載指定磁碟區或檔案共享陰影複製之裝置的名稱。
CVssWriter：：Initialize 初始化 CVssWriter 物件，並允許寫入器應用程式與 VSS 互動。
CVssWriter：：InstallAlternateWriter 不支援。 (CVssWriter.InstallAlternateWriter)
CVssWriter：：IsBootableSystemStateBackedUp IsBootableSystemStateBackedUp 方法會指出是否要備份可開機狀態。
CVssWriter：：IsPartialFileSupportEnabled IsPartialFileSupportEnabled 方法會決定部分檔案支援是否已啟用或停用。
CVssWriter：：IsPathAffected IsPathAffected 方法會決定指定的目錄或檔案是否包含在目前的陰影複製集中。 目錄或檔案的路徑可以是遠端檔案共用的本機路徑或 UNC 路徑。
CVssWriter：：OnAbort 在 VSS 發出的中止事件之後，會呼叫 OnAbort 方法，指出陰影複製作業已提前終止。 寫入器會使用這個方法來清除嘗試參與該作業。
CVssWriter：：OnBackOffIOOnVolume 不支援。 (CVssWriter.OnBackOffIOOnVolume)
CVssWriter：：OnBackupComplete OnBackupComplete 方法是由執行 BackupComplete 事件的寫入器呼叫。 它會用來執行備份之後所考慮的作業。 不過，這些作業無法修改備份元件檔。
CVssWriter：：OnBackupShutdown OnBackupShutdown 方法是由執行 BackupShutdown 事件的寫入器呼叫。 當備份應用程式關閉時，它會用來執行所需的作業，特別是在備份應用程式當機時。
CVssWriter：：OnContinueIOOnVolume 不支援。 (CVssWriter.OnContinueIOOnVolume)
CVssWriter：：OnFreeze OnFreeze 方法是由在陰影複製凍結開始時收到 Freeze 事件的寫入器呼叫。 寫入器會使用這個方法來執行參與凍結或凍結所需的作業。
CVssWriter：：OnIdentify OnIdentify 方法是由接收識別事件的寫入器呼叫。
CVssWriter：：OnPostRestore OnPostRestore 方法是由 PostRestore 事件後面的寫入器呼叫。 它會用來執行要求者還原至磁碟之後，所考慮的作業。 不過，這些作業無法修改備份元件檔。
CVssWriter：：OnPostSnapshot OnPostSnapshot 方法是由 PostSnapshot 事件後面的寫入器呼叫。
CVssWriter：：OnPrepareBackup OnPrepareBackup 方法是由執行 PrepareForBackup 事件的寫入器呼叫。 這個方法可用來設定寫入器的狀態及其元件，以準備備份作業。
CVssWriter：：OnPrepareSnapshot OnPrepareSnapshot 方法是由寫入器呼叫，以處理 PrepareForSnapshot 事件。 它可用來執行準備寫入器以參與陰影複製或 veto 陰影複製所需的作業。
CVssWriter：：OnPreRestore OnPreRestore 方法是由在 PreRestore 事件之後的寫入器呼叫。
CVssWriter：：OnThaw OnThaw 方法是由在 Thaw 事件之後的寫入器呼叫。
CVssWriter：：OnVSSApplicationStartup 不支援。 (CVssWriter.OnVSSApplicationStartup)
CVssWriter：：OnVSSShutdown 不支援。 (CVssWriter.OnVssShutdown)
CVssWriter：：SetWriterFailure SetWriterFailure 方法表示此寫入器發生錯誤狀況並設定錯誤條件。
CVssWriter：：Subscribe Subscribe 方法會使用 VSS 訂閱寫入器。
CVssWriter：：Unsubscribe Unsubscribe 方法會使用 VSS 取消訂閱寫入器。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	vswriter.h (包括 Vss.h、VsWriter.h)