通过

IVssComponent：：GetAdditionalRestores 方法 (vswriter.h)

  • 项目

编写器在增量或差异还原操作期间使用 GetAdditionalRestores 方法来确定给定组件是否需要执行其他还原操作才能完全检索它。

编写器或请求者都可以调用此方法。

语法

HRESULT GetAdditionalRestores(
  [out] bool *pbAdditionalRestores
);

参数

[out] pbAdditionalRestores

调用方分配的变量的地址，如果对当前组件进行其他还原，则接收 true ;否则为 false 。

返回值

下面是此方法的有效返回代码。

值 含义
S_OK
 已成功返回属性值。
S_FALSE
 指定的属性没有值。
E_INVALIDARG
 其中一个参数值无效。
E_OUTOFMEMORY
 调用方内存不足或其他系统资源。
VSS_E_INVALID_XML_DOCUMENT
 XML 文档无效。 有关详细信息，请查看事件日志。 有关详细信息，请参阅 VSS 下的事件和错误处理。

注解

GetAdditionalRestores 返回的值将为 false，除非在还原操作期间请求者调用 IVssBackupComponents：：SetAdditionalRestores。

如果需要使用多个备份集来完全还原组件，则应使用 GetAdditionalRestores 检查。 可以通过从完整备份还原数据，然后从一个或多个后续增量备份或差异备份更新该数据来检索组件。

GetAdditionalRestores 方法通常由支持显式恢复机制的编写者使用，作为其 PostRestore 事件处理程序的一部分 (CVssWriter：：OnPostRestore) ，例如，Exchange Server和数据库应用程序（如 SQL Server）。 对于这些应用程序，在执行此类恢复后，通常无法执行其他差异还原、增量还原或日志还原。

因此，如果 GetAdditionalRestores 为组件返回 true ，则此类编写器不应执行其显式恢复机制，并且应预期将完成其他差异还原、增量还原或日志还原。

当 SetAdditionalRestores 返回 false 时，还原完成后，在处理 PostRestore 事件时，编写器可以完成其恢复操作并重新联机。

要求

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

另请参阅

IVssComponent