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 によって割り当てる必要があります。 スナップインは、MMC によって解放されるため、 pstrPersistableViewDescription を解放することはできません。
戻り値
成功した場合、戻り値はS_OK。 その他の戻り値は、エラー コードを示します。
注釈
結果ビューの作成時に、MMC はスナップインの IComponent2::GetResultViewType2 メソッドを呼び出します。 ユーザーが *pResultViewType の pstrPersistableViewDescription メンバーによって名前付けされた結果ビューに戻ると、MMC はスナップインの IComponent2::RestoreResultView メソッドを呼び出します。この時点で、スナップインは復元された結果ビューのスナップイン固有の詳細 (存在する場合) を提供できます。 ユーザーは、MMC の [戻る]/[転送 ] ボタン、または保存されたコンソール ファイルの読み込みによって、結果ビューを再び表示します。 IComponent2::GetResultViewType2 メソッドと IComponent2::RestoreResultView メソッドの使用方法の詳細については、「結果ビューの復元」を参照してください。
スナップインが OCX (ActiveX コントロール) ビューを実装している場合、スナップインは OCX を作成し、RESULT_VIEW_TYPE_INFO構造体 (具体的には構造体の pUnkControl メンバー) に OCX IUnknown ポインターを MMC に提供します。 スナップインは OCX の作成を制御できるため、スナップインは必要に応じてライセンスまたはセキュリティの問題に対処できます。 GetResultViewType2 の呼び出し中に、スナップインで OCX を初期化することもできます (スナップインはMMCN_INITOCX通知を受け取りません)。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | mmc.h |