IComponent2：：RestoreResultView 方法 (mmc.h)

项目
08/24/2023

RestoreResultView 方法还原结果视图。此方法使管理单元能够还原结果视图的特定于管理单元的详细信息。有关详细信息，请参阅还原结果视图。

语法

HRESULT RestoreResultView(
  [in] MMC_COOKIE             cookie,
  [in] PRESULT_VIEW_TYPE_INFO pResultViewType
);

参数

[in] cookie

一个值，该值指定将还原其结果视图的唯一标识符。

[in] pResultViewType

指向结果视图 RESULT_VIEW_TYPE_INFO 结构的指针。

返回值

如果成功，则返回值S_OK。管理单元可以返回S_FALSE，以防止 MMC 根据 *pResultViewType 中的信息还原视图。其他返回值指示错误代码。

注解

*pResultViewType 的 pstrPersistableViewDescription 成员指定分配给结果视图的名称。若要还原 由 pstrPersistableViewDescription 成员标识的结果视图，该管理单元将填充 *pResultViewType 的其余成员。结果视图的名称最初是在管理单元实现 IComponent2：：GetResultViewType2 期间分配的。 MMC 调用 IComponent2：：RestoreResultView ，以便在用户重新访问结果视图时，管理单元可以还原内部视图设置。

当用户自定义视图时，MMC 会知道某些 (设置（如视图选项或视图模式) ），而某些 (（如事件查看器管理单元) 中的最早 First）位于管理单元内部。在 MMC 2.0 之前，没有 MMC 与管理单元通信以还原内部视图设置的机制。但是，MMC 2.0 中的 IComponent2：：GetResultViewType2 和 IComponent2：：RestoreResultView 方法提供了还原内部视图设置的机制。管理单元针对 RESULT_VIEW_TYPE_INFO 结构的 pstrPersistableViewDescription 成员保留内部视图设置。当 MMC 调用 IComponent2：：RestoreResultView 还原结果视图时，管理单元使用持久化设置来完成视图还原。

用户通过按 MMC 后退/转发 按钮或加载已保存的控制台文件来重新访问结果视图。