(vswriter.h) 的 IVssComponent 类

IVssComponent 接口是 C++ (不是 COM) 接口，其中包含用于检查和修改请求者的备份组件文档中包含的组件的信息的方法。

对于在备份操作期间通过 IVssBackupComponents：：AddComponent 方法显式添加到备份组件文档的那些组件，只能获取 IVssComponent 对象。

有关在还原操作期间使用 IVssBackupComponents：：AddRestoreSubcomponent 显式添加的组件的信息无法通过 IVssComponent 接口获取。

通过 IVssComponent 对象提供的组件和隐式选择的子组件共有的一些信息包括：

• 备份时间戳
• 还原前/还原后失败消息
• 还原元数据
• 还原目标

IVssComponent 对象中的某些信息基于每个文件，可以引用由显式选择的组件或隐式选择的子组件管理的文件：

• 备用位置映射
• 部分文件
• 定向目标

其他信息不包括在备份组件文档中，可以使用 IVssComponent 对象与相应的编写器元数据文档（基于编写器的组件层次结构在逻辑路径中表示）进行推断 (请参阅 使用选择性和逻辑路径) 。

接口可由编写器或请求者使用，尽管某些方法仅支持编写器。 通过这种方式，编写器可以请求备份或还原操作中的更改，例如添加新目标，或了解请求者操作，例如使用备用位置。

以下方法返回 IVssComponent 接口：

• IVssWriterComponents：：GetComponent
• IVssWriterComponentsExt：：GetComponent

继承

IVssComponent 接口继承自 IUnknown 接口。 IVssComponent 还具有以下类型的成员：

方法

IVssComponent 类具有以下方法。

IVssComponent：：AddDifferencedFilesByLastModifyLSN 不支持。 (IVssComponent.AddDifferencedFilesByLastModifyLSN)
IVssComponent：：AddDifferencedFilesByLastModifyTime 由编写器用来指示 (指定文件) 的文件集应根据上次修改时间戳进行评估，以便使用整个文件包含在带时间戳的增量备份或差异备份中。
IVssComponent：：AddDirectedTarget AddDirectedTarget 方法允许编写器在还原时指示在还原文件时，它 (应重新映射源文件) 。
IVssComponent：：AddPartialFile AddPartialFile 方法指示仅备份给定文件的某些部分，以及这些部分。
IVssComponent：：GetAdditionalRestores 编写器在增量或差异还原操作期间使用 GetAdditionalRestores 方法来确定给定组件是否需要执行其他还原操作才能完全检索它。
IVssComponent：：GetAlternateLocationMapping GetAlternateLocationMapping 用于返回文件集的文件还原备用位置。 此方法可由编写器或请求者调用。
IVssComponent：：GetAlternateLocationMappingCount GetAlternateLocationMappingCount 方法返回请求者在还原数据时使用的备用位置映射的数目。 编写器或请求者可以调用此方法。
IVssComponent：：GetBackupMetadata GetBackupMetadata 方法检索特定于编写器的专用备份元数据，这些元数据可能是在 PrepareForBackup 事件期间由 CVssWriter：：OnPrepareBackup 使用 IVssComponent：：SetBackupMetadata 设置的。
IVssComponent：：GetBackupOptions GetBackupOptions 方法将指定的备份选项返回给编写器，该编写器使用 IVssBackupComponents：：SetBackupOptions 管理请求者设置的当前所选组件或组件。
IVssComponent：：GetBackupStamp GetBackupStamp 方法返回由编写器为给定组件存储的备份标记字符串。
IVssComponent：：GetBackupSucceeded GetBackupSucceeded 方法返回完全尝试将所选组件或组件集的所有文件备份为VSS_FILE_RESTORE_STATUS枚举的状态。
IVssComponent：：GetComponentName GetComponentName 方法返回此组件的逻辑名称。
IVssComponent：：GetComponentType GetComponentType 方法根据VSS_COMPONENT_TYPE枚举返回此组件的类型。
IVssComponent：：GetDifferencedFile GetDifferencedFile 方法返回有关文件集的信息， (指定文件或文件) 作为差异文件参与增量备份或差异备份或还原，即实现与其关联的备份和还原，就像将整个文件复制到备份媒体 (一样，而不是使用部分文件) 。
IVssComponent：：GetDifferencedFilesCount 返回此组件 (以及组件集的任何子组件中文件规范的数目，该组件集定义) 由支持增量备份或还原的编写器标记为差异文件。
IVssComponent：：GetDirectedTarget GetDirectedTarget 方法在备份时将编写器存储的信息返回给备份组件文档，以指示在还原文件时，它 (应重新映射源文件) 。
IVssComponent：：GetDirectedTargetCount GetDirectedTargetCount 方法返回与当前组件关联的定向目标规范的数目。 编写器或请求者可以调用此方法。
IVssComponent：：GetFileRestoreStatus GetFileRestoreStatus 方法返回已完成尝试将所选组件或组件集的所有文件还原为VSS_FILE_RESTORE_STATUS枚举的状态。
IVssComponent：：GetLogicalPath GetLogicalPath 方法返回此组件的逻辑路径。
IVssComponent：：GetNewTarget GetNewTarget 方法返回所选组件或组件集的新文件还原位置。
IVssComponent：：GetNewTargetCount GetNewTargetCount 方法返回与给定组件关联的新目标还原位置数。
IVssComponent：：GetPartialFile GetPartialFile 方法返回与此组件关联的分部文件的相关信息。
IVssComponent：：GetPartialFileCount GetPartialFileCount 方法返回与组件关联的部分文件的数目。
IVssComponent：：GetPostRestoreFailureMsg 如果 IVssComponent：：SetPostRestoreFailureMsg 设置了一个，则 GetPostRestoreFailureMsg 方法返回编写器在处理 PostRestore 事件时生成的失败消息。
IVssComponent：：GetPreRestoreFailureMsg 如果 IVssComponent：：SetPreRestoreFailureMsg 设置了一个，则 GetPreRestoreFailureMsg 方法检索编写器在处理 PreRestore 事件时生成的错误消息。
IVssComponent：：GetPreviousBackupStamp GetPreviousBackupStamp 方法返回请求者在备份组件文档中加载的上一个备份标记。 编写器在决定文件应参与差异备份操作还是增量备份操作时使用该值。
IVssComponent：：GetRestoreMetadata GetRestoreMetadata 方法检索专用的特定于编写器的还原元数据，这些元数据可能是在 PreRestore 事件期间由 CVssWriter：：OnPreRestore 使用 IVssComponent：：SetRestoreMetadata 设置的。
IVssComponent：：GetRestoreOptions GetRestoreOptions 方法获取请求者使用 IVssBackupComponents：：SetRestoreOptions 为当前编写器指定的还原选项。
IVssComponent：：GetRestoreSubcomponent GetRestoreSubcomponent 方法返回与给定组件关联的指定子组件。
IVssComponent：：GetRestoreSubcomponentCount GetRestoreSubcomponentCount 方法返回与组件关联的子组件数。
IVssComponent：：GetRestoreTarget GetRestoreTarget 方法根据当前组件的VSS_RESTORE_TARGET枚举) 返回还原目标 (。
IVssComponent：：IsSelectedForRestore IsSelectedForRestore 方法确定是否已选择要还原的当前组件。
IVssComponent：：SetBackupMetadata SetBackupMetadata 方法使用 组件设置备份元数据。
IVssComponent：：SetBackupStamp SetBackupStamp 方法设置一个字符串，其中包含指示备份时间的信息。
IVssComponent：：SetPostRestoreFailureMsg SetPostRestoreFailureMsg 方法用于创建描述处理 PostRestore 事件失败的消息。
IVssComponent：：SetPreRestoreFailureMsg SetPreRestoreFailureMsg 方法用于创建描述处理 PreRestore 事件失败的消息。
IVssComponent：：SetRestoreMetadata SetRestoreMetadata 方法为当前组件设置特定于编写器的元数据。
IVssComponent：：SetRestoreTarget SetRestoreTarget 方法根据当前组件的VSS_RESTORE_TARGET枚举) 设置还原目标 (。

要求

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