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 方法。 当用户重新访问由 *pResultViewType 的 pstrPersistableViewDescription 成员命名的结果视图时,MMC 将调用管理单元的 IComponent2::RestoreResultView 方法,此时,如果还原的结果视图有任何) ,管理单元可以提供特定于管理单元的详细信息 (。 用户通过 MMC 后退/转发 按钮或加载已保存的控制台文件来重新访问结果视图。 有关 使用 IComponent2::GetResultViewType2 和 IComponent2::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 |