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 AreComponentsSelected 方法指示请求者是否在组件模式下运行，并支持选择要备份的单个组件或备份整个卷。
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 在卷影复制冻结开始时收到 Freeze 事件时，编写器会调用 OnFreeze 方法。 编写器使用此方法执行参与冻结或否决冻结所需的操作。
CVssWriter：：OnIdentify 在收到 Identify 事件后，编写器将调用 OnIdentify 方法。
CVssWriter：：OnPostRestore OnPostRestore 方法由编写器在 PostRestore 事件后调用。 它用于在请求者将文件还原到磁盘后执行认为必要的操作。 但是，这些操作无法修改备份组件文档。
CVssWriter：：OnPostSnapshot OnPostSnapshot 方法由编写器在 PostSnapshot 事件后调用。
CVssWriter：：OnPrepareBackup OnPrepareBackup 方法由编写器在 PrepareForBackup 事件后调用。 此方法用于配置编写器的状态及其组件，以便为备份操作做准备。
CVssWriter：：OnPrepareSnapshot 编写器调用 OnPrepareSnapshot 方法来处理 PrepareForSnapshot 事件。 它用于执行准备编写器以参与卷影复制或否决卷影副本所需的操作。
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 取消订阅方法使用 VSS 取消订阅编写器。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	vswriter.h (包括 Vss.h、VsWriter.h)