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

查询方法查询系统上的提供程序和/或位于当前上下文中的系统中已完成的卷影副本。 该方法只能在备份操作期间调用。
IVssBackupComponents::QueryRevertStatus

返回一个 IVssAsync 接口指针,该指针可用于确定还原操作的状态。 (IVssBackupComponents.QueryRevertStatus)
IVssBackupComponents::RevertToSnapshot

将卷还原到以前的卷影副本。 (IVssBackupComponents.RevertToSnapshot)
IVssBackupComponents::SaveAsXML

SaveAsXML 方法将包含请求者状态信息的备份组件文档保存到指定的字符串。 此 XML 文档(包含备份组件文档)应始终安全保存为备份操作的一部分。
IVssBackupComponents::SetAdditionalRestores

在增量或差异还原操作期间,请求者使用 SetAdditionalRestores 方法,以指示给定组件需要其他还原操作才能完全检索它。
IVssBackupComponents::SetBackupOptions

SetBackupOptions 方法设置组件的专用或依赖编写器的备份参数字符串。
IVssBackupComponents::SetBackupState

SetBackupState 方法定义备份操作的总体配置。
IVssBackupComponents::SetBackupSucceeded

SetBackupSucceededed 方法指示特定编写器的指定组件的备份是否成功。
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)