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 |