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 |