CVssWriter：：OnPostRestore 方法 (vswriter.h)

OnPostRestore 方法由编写器在 PostRestore 事件后调用。 它用于在请求者将文件还原到磁盘后执行认为必要的操作。 但是，这些操作无法修改备份组件文档。

OnPostRestore 是一种虚拟方法。 它由 CVssWriter 基类实现，但可由派生类重写。

语法

bool OnPostRestore(
  [in] IVssWriterComponents *pComponent
);

参数

[in] pComponent

指向 VSS 传入的 IVssWriterComponents 对象的指针，为方法提供对编写器的组件信息的访问权限。 如果 CVssWriter：：AreComponentsSelected 返回 false) ，则请求方不支持组件 (，则此参数的值可能为 NULL。

返回值

由基类实现的 OnPostRestore 始终返回 true。

此方法的任何其他实现都必须返回 true ，出现致命错误时除外。 如果发生严重错误，方法必须调用 CVssWriter：：SetWriterFailure 方法，以在返回 false 之前提供失败说明。 如果发生非严重错误，该方法仍应调用 SetWriterFailure ，但返回 true。 如果错误是由暂时性问题引起的，则 方法应在对 SetWriterFailure 的调用中指定VSS_E_WRITERERROR_RETRYABLE。

在发生故障的所有情况下，方法都应将事件写入事件日志，以报告失败的确切原因。

注解

CVssWriter 基类对此方法的默认实现返回 true，而不执行任何其他操作。

如有必要，编写器应删除任何临时文件并释放参与还原所需的任何系统资源。

编写器绝不应从此方法或任何其他 CVssWriter (Ex) ：：OnXxx 回调方法引发异常。

生成 PostRestore 事件后，请求者的备份组件文档将成为只读文档。 因此，尝试通过接口修改文档 (例如，调用 IVssComponent：：SetRestoreMetadata) 将在 OnPostRestore 的用户实现中失败。

如果此方法调用 CVssWriterEx2：：GetSessionId、 CVssWriter：：SetWriterFailure 或 CVssWriterEx2：：SetWriterFailureEx 方法 ，则必须在调用此方法的同一线程中执行此操作。 有关详细信息，请参阅 编写器事件处理。

要求

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

另请参阅

CVssWriter

IVssWriterComponents