CVssWriter 類別 (vswriter.h)
CVssWriter 類別是抽象基類，可定義寫入器與 VSS 和其他寫入器同步處理其狀態的介面。
每個寫入器都必須具現化衍生自 CVssWriter 的物件。
衍生自 CVssWriter 的對象必須為所有 CVssWriter 的純虛擬方法提供實作。
寫入器可以覆寫一或所有 CVssWriter 的虛擬方法。
若要參與 VSS，寫入器必須先呼叫 CVssWriter：：Initialize ，然後呼叫 CVssWriter：：Subscribe。
寫入器會呼叫 CVssWriter：：Unsubscribe 終止其參與。
CVssWriter 基類負責傳遞至事件處理程式的介面生命週期。 其中包括下列項目：
- 傳遞至下列專案的 IVssWriterComponents 介面實例： CVssWriter：：OnPrepareBackup
- 傳遞至 CVssWriter：：OnIdentify 之 IVssCreateWriterMetadata 介面的實例。
方法
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) |