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