IComponent2::RestoreResultView 方法 (mmc.h)
RestoreResultView 方法會還原結果檢視。 此方法可讓嵌入式管理單元還原結果檢視的特定嵌入式管理單元詳細數據。 如需詳細資訊,請參閱 還原結果檢視。
這個方法會取代使用 MMCN_RESTORE_VIEW 通知。
語法
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 所知道,而某些 (例如 事件檢視器 嵌入式管理單元) 最舊的第一個) 是在嵌入式管理單元內部。 在 MMC 2.0 之前,沒有任何機制可讓 MMC 與嵌入式管理單元通訊,以還原內部檢視設定。 不過,MMC 2.0 中的 IComponent2::GetResultViewType2 和IComponent2::RestoreResultView 方法會提供還原內部檢視設定的機制。 嵌入式管理單元會針對 RESULT_VIEW_TYPE_INFO 結構的 pstrPersistableViewDescription 成員保存內部檢視設定。 當 MMC 呼叫 IComponent2::RestoreResultView 來還原結果檢視時,嵌入式管理單元會使用保存的設定來完成檢視還原。
使用者按下 MMC [上一頁/轉寄 ] 按鈕或載入已儲存的主控台檔案,以重新瀏覽結果檢視。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | mmc.h |