IComponent2::GetResultViewType2 方法 (mmc.h)

GetResultViewType2 方法检索结果视图类型。 此方法取代 IComponent::GetResultViewType 方法。

语法

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

参数

[in] cookie

一个 值,该值指定范围项由 snapin 提供的唯一标识符。 有关 MMC 中的 Cookie 的详细信息,请参阅 Cookie

[in, out] pResultViewType

指向结果视图 RESULT_VIEW_TYPE_INFO 结构的指针。 如果管理单元实现 IComponent2,则 RESULT_VIEW_TYPE_INFO 结构的 pstrPersistableViewDescription 成员必须包含有效的视图说明字符串;否则,MMC 将不会初始化管理单元。 pstrPersistableViewDescription 成员必须由 CoTaskMemAlloc 分配。 管理单元不得释放 pstrPersistableViewDescription,因为它将由 MMC 释放。

返回值

如果成功,则返回值S_OK。 其他返回值指示错误代码。

注解

在创建结果视图期间,MMC 调用管理单元的 IComponent2::GetResultViewType2 方法。 当用户重新访问由 *pResultViewTypepstrPersistableViewDescription 成员命名的结果视图时,MMC 将调用管理单元的 IComponent2::RestoreResultView 方法,此时,如果还原的结果视图有任何) ,管理单元可以提供特定于管理单元的详细信息 (。 用户通过 MMC 后退/转发 按钮或加载已保存的控制台文件来重新访问结果视图。 有关 使用 IComponent2::GetResultViewType2IComponent2::RestoreResultView 方法的详细信息,请参阅 还原结果视图

如果管理单元在视图) 实现 OCX (ActiveX 控件,则该管理单元将创建 OCX,并为 MMC 提供RESULT_VIEW_TYPE_INFO结构中的 OCX IUnknown 指针,具体 (结构的 pUnkControl 成员) 。 管理单元可以控制 OCX 的创建,因此该管理单元可以根据需要解决许可或安全问题。 在调用 GetResultViewType2 期间,管理单元还可以初始化 OCX, (管理单元不会收到 ) MMCN_INITOCX 通知。

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 mmc.h

另请参阅

IComponent2::RestoreResultView

RESULT_VIEW_TYPE_INFO

还原结果视图