CVssWriter：：OnPreRestore 方法 (vswriter.h)

OnPreRestore 方法由编写器在 PreRestore 事件后调用。 此方法用于将编写器置于支持还原的状态（例如，使数据库服务脱机），并在正在还原文件的请求者的备份组件文档中进行修改 (例如将还原目标设置为替代原始还原方法) 。

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

语法

bool OnPreRestore(
  [in] IVssWriterComponents *pComponent
);

参数

[in] pComponent

指向 IVssWriterComponents 对象的实例化指针，该对象包含与请求者的备份组件文档中的当前编写器关联的组件。

返回值

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

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

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

注解

PreRestore 事件发生在实际还原备份数据之前。 这是编写器确定正在还原的内容的机会。

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

此方法使编写器能够确定要还原的内容、检索存储的备份组件文档中存储的专用元数据并更新该数据。

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

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

要求

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

另请参阅

CVssWriter

CVssWriter：：OnPostSnapshot

CVssWriter：：OnPrepareBackup

CVssWriter：：SetWriterFailure

IVssWriterComponents