IVssBackupComponents 类 (vsbackup.h)
请求者使用 IVssBackupComponents 接口轮询编写器文件状态并运行备份/还原操作。
应用程序通过调用 CreateVssBackupComponents 获取 IVssBackupComponents 接口的实例。
IVssBackupComponents 对象只能用于单个备份、还原或查询操作。
备份、还原或查询操作成功完成或显式终止后,请求者必须通过调用 IVssBackupComponents::Release 释放 IVssBackupComponents 对象。 不得重复使用 IVssBackupComponents 对象。 例如,不能使用已用于查询操作的同一 IVssBackupComponents 对象执行备份或还原操作。
继承
IVssBackupComponents 接口继承自 IUnknown 接口。 IVssBackupComponents 也具有以下类型的成员:
方法
IVssBackupComponents 类具有这些方法。
IVssBackupComponents::AbortBackup AbortBackup 方法通知 VSS 备份操作已终止。 |
IVssBackupComponents::AddAlternativeLocationMapping 请求者使用 AddAlternativeLocationMapping 方法指示已使用备用位置映射还原给定组件中文件集的所有成员。 |
IVssBackupComponents::AddComponent 用于显式添加到备份集。 |
IVssBackupComponents::AddNewTarget 在还原操作期间,请求者使用 AddNewTarget 方法来指示备份应用程序计划将文件还原到新位置。 |
IVssBackupComponents::AddRestoreSubcomponent 指示要还原组件集的子组件成员,该组件集已标记为不可选择进行备份,但标记为可进行还原。 |
IVssBackupComponents::AddToSnapshotSet AddToSnapshotSet 方法将原始卷或原始远程文件共享添加到卷影副本集。 |
IVssBackupComponents::BackupComplete BackupComplete 方法会导致 VSS 生成 BackupComplete 事件,该事件向编写者发出备份过程已完成的信号。 |
IVssBackupComponents::BreakSnapshotSet BreakSnapshotSet 方法会导致 VSS“忘记”卷影副本集的存在。 |
IVssBackupComponents::D eleteSnapshots DeleteSnapshots 方法删除一个或多个卷影副本或卷影副本集。 |
IVssBackupComponents::D isableWriterClasses DisableWriterClasses 方法阻止特定类编写器接收任何事件。 |
IVssBackupComponents::D isableWriterInstances DisableWriterInstances 方法禁用指定的编写器实例。 |
IVssBackupComponents::D oSnapshotSet 同时提交此集中的所有卷影副本。 |
IVssBackupComponents::EnableWriterClasses EnableWriterClasses 方法使指定的编写器能够接收所有事件。 |
IVssBackupComponents::ExposeSnapshot ExposeSnapshot 方法将卷影副本公开为驱动器号、装载的文件夹或文件共享。 |
IVssBackupComponents::FreeWriterMetadata FreeWriterMetadata 方法释放在调用 IVssBackupComponents::GatherWriterMetadata 时分配的系统资源。 |
IVssBackupComponents::FreeWriterStatus FreeWriterStatus 方法释放在调用 IVssBackupComponents::GatherWriterStatus 期间分配的系统资源。 |
IVssBackupComponents::GatherWriterMetadata CollectWriterMetadata 方法提示每个编写器发送他们收集的元数据。 方法将生成一个用于与编写器通信的标识事件。 |
IVssBackupComponents::GatherWriterStatus GatherWriterStatus 方法提示每个编写器发送状态消息。 |
IVssBackupComponents::GetSnapshotProperties GetSnapshotProperties 方法获取指定卷影副本的属性。 |
IVssBackupComponents::GetWriterComponents GetWriterComponents 方法用于返回有关已存储在请求者的备份组件文档中的给定编写器组件的信息。 |
IVssBackupComponents::GetWriterComponentsCount GetWriterComponentsCount 方法返回其组件已添加到请求者的备份组件文档中的编写器的数量。 |
IVssBackupComponents::GetWriterMetadata GetWriterMetadata 方法返回系统中运行的特定编写器的元数据。 |
IVssBackupComponents::GetWriterMetadataCount GetWriterMetadataCount 方法返回包含元数据的编写器数。 |
IVssBackupComponents::GetWriterStatus GetWriterStatus 方法返回指定编写器的状态。 |
IVssBackupComponents::GetWriterStatusCount GetWriterStatusCount 方法返回具有状态的编写器数。 |
IVssBackupComponents::ImportSnapshots 导入从其他计算机传输的卷影副本。 |
IVssBackupComponents::InitializeForBackup InitializeForBackup 方法初始化备份组件元数据,为备份做准备。 |
IVssBackupComponents::InitializeForRestore InitializeForRestore 方法初始化 IVssBackupComponents 接口,为还原操作做准备。 |
IVssBackupComponents::IsVolumeSupported IsVolumeSupported 方法确定指定的提供程序是否支持指定卷或远程文件共享上的卷影副本。 |
IVssBackupComponents::P ostRestore PostRestore 方法将导致 VSS 生成 PostRestore 事件,并指示编写器当前还原操作已完成。 |
IVssBackupComponents::P repareForBackup PrepareForBackup 方法将导致 VSS 生成 PrepareForBackup 事件,并指示编写器为即将进行的备份操作做好准备。 这样,编写者可以使用请求者的备份组件文档。 |
IVssBackupComponents::P reRestore PreRestore 方法将导致 VSS 生成 PreRestore 事件,并指示编写器为即将进行的还原操作做好准备。 |
IVssBackupComponents::Query Query 方法查询系统中驻留在当前上下文中的系统上的提供程序和/或已完成的卷影副本。 只能在备份操作期间调用 方法。 |
IVssBackupComponents::QueryRevertStatus 返回可用于确定还原操作状态的 IVssAsync 接口指针。 (IVssBackupComponents.QueryRevertStatus) |
IVssBackupComponents::RevertToSnapshot 将卷还原到以前的卷影副本。 (IVssBackupComponents.RevertToSnapshot) |
IVssBackupComponents::SaveAsXML SaveAsXML 方法将包含请求者状态信息的备份组件文档保存到指定的字符串中。 此 XML 文档(包含备份组件文档)应始终安全地保存为备份操作的一部分。 |
IVssBackupComponents::SetAdditionalRestores 请求者在增量或差异还原操作期间使用 SetAdditionalRestores 方法,向编写者指示给定组件需要其他还原操作才能完全检索它。 |
IVssBackupComponents::SetBackupOptions SetBackupOptions 方法为组件设置一个私有或依赖于编写器的备份参数的字符串。 |
IVssBackupComponents::SetBackupState SetBackupState 方法定义备份操作的总体配置。 |
IVssBackupComponents::SetBackupSucceeded SetBackupSucceeded 方法指示特定编写器的指定组件的备份是否成功。 |
IVssBackupComponents::SetContext SetContext 方法为后续卷影复制相关操作设置上下文。 |
IVssBackupComponents::SetFileRestoreStatus SetFileRestoreStatus 方法指示是成功还原了部分文件、所有文件还是未成功还原任何文件。 |
IVssBackupComponents::SetPreviousBackupStamp SetPreviousBackupStamp 方法设置早期备份操作的备份标记,差异备份操作或增量备份操作将基于该标记。 |
IVssBackupComponents::SetRangesFilePath 当部分文件操作需要范围文件,并且该文件已还原到其原始文件以外的其他位置时,将使用 SetRangesFilePath 方法。 |
IVssBackupComponents::SetRestoreOptions SetRestoreOptions 方法为编写器组件设置一个私有或依赖于编写器的还原参数的字符串。 |
IVssBackupComponents::SetRestoreState SetRestoreState 方法定义还原操作的总体配置。 |
IVssBackupComponents::SetSelectedForRestore SetSelectedForRestore 方法指示是否选择指定的可选组件进行还原。 |
IVssBackupComponents::StartSnapshotSet StartSnapshotSet 方法创建新的空卷影副本集。 |
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h) |