次の方法で共有

IConsole2::Expand メソッド (mmc.h)

  • [アーティクル]

IConsole2::Expand メソッドを使用すると、スナップインでスコープ ウィンドウ内のアイテムを展開または折りたたみできます。

構文

HRESULT Expand(
  [in] HSCOPEITEM hItem,
  [in] BOOL       bExpand
);

パラメーター

[in] hItem

展開する項目へのハンドル。

[in] bExpand

項目を展開するか折りたたむかを指定する値。 TRUE を指定 すると、項目が展開されます。 FALSE を指定 すると、アイテムが折りたたまれます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

解説

IConsole2::Expand メソッドは、ユーザーがプラス記号またはマイナス記号をクリックして、スコープ ウィンドウ内の項目を展開または折りたたむプログラムに相当します。 つまり、このメソッドを使用すると、スコープ ウィンドウ内の項目の展開または折りたたみが表示されます。 このメソッドは、スコープ ウィンドウの選択範囲を変更せず、結果ウィンドウに影響を与えないことに注意してください。

このメソッドが呼び出されると、MMC は bExpand に設定された値に基づいて hItem で指定された項目を展開または折りたたみします。 その後、MMC は展開通知を各子項目のスナップインに送信します。 MMC では、各子スナップインの IComponentData::Notify メソッドを呼び出し、イベントを MMCN_EXPAND に設定し、lpDataObject を hItem のデータ オブジェクトへのポインターとして設定し、arg を bExpand に基づいて TRUE または FALSE に設定し、param をhItem として設定します。 hItem は、IConsole2::Expand の呼び出しで指定した HSCOPEITEM ハンドルであることに注意してください。

IConsole2::Expand メソッドは、特定のビューにのみ適用されます。 これは、コンソール内の特定の複数ドキュメント インターフェイス (MDI) ウィンドウに表示されるスナップイン項目に対応するスナップインの IComponent オブジェクトのインスタンスにのみ適用されることを意味します。 コンソール内の各 MDI ウィンドウは異なるビューを表し、MDI ウィンドウ内のスナップインのインスタンスがそのスナップインの IComponent オブジェクトに対応していることに注意してください。

そのため、スナップインでは、IComponent オブジェクトに関連付けられている IConsole2 インターフェイス ポインター (つまり、IComponent::Initialize によって返される IConsole インターフェイス ポインターで QueryInterface を呼び出すことによって取得された IConsole2 インターフェイス ポインター) でのみこのメソッドを呼び出す必要があります。

名前空間内のアイテムの子項目を、目に見えて展開せずに列挙するには、スナップインで IConsoleNameSpace2::Expand メソッドを使用する必要があります。

要件

   
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー mmc.h
[DLL] Mmcndmgr.dll

関連項目

IConsole2

IConsoleNameSpace2::Expand