CVssWriter 类 (vswriter.h)

CVssWriter 类是一个抽象基类,用于定义编写器将状态与 VSS 和其他编写器同步的接口。

每个编写器都必须实例化派生自 CVssWriter 的对象

派生自 CVssWriter 的对象必须为所有 CVssWriter 的纯虚拟方法提供实现。

编写器可以替代一个或所有 CVssWriter 的虚拟方法。

若要参与 VSS,编写器必须先调用 CVssWriter::Initialize ,然后调用 CVssWriter::Subscribe

编写者通过调用 CVssWriter::Unsubscribe 来终止其参与。

CVssWriter 基类负责传递给事件处理程序的接口的生命周期。 这包括:

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)