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 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) |