IComponent2::GetResultViewType2 方法 (mmc.h)
GetResultViewType2 方法會擷取結果檢視類型。 這個方法會取代 IComponent::GetResultViewType 方法。
語法
HRESULT GetResultViewType2(
[in] MMC_COOKIE cookie,
[in, out] PRESULT_VIEW_TYPE_INFO pResultViewType
);
參數
[in] cookie
值,指定範圍專案之嵌入式管理單元提供的唯一標識符。 如需 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 |