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之資料物件的指標、根據bExpand將 arg set 設為TRUE或FALSE,並將param設定為hItem。 請注意,hItem是您呼叫IConsole2::Expand中指定的HSCOPEITEM控制碼。
IConsole2::Expand方法僅適用于特定檢視。 這表示它只適用于嵌入式管理單元 IComponent 物件的實例,該物件對應至主控台內特定多文檔介面中顯示的嵌入式管理單元專案, (MDI) 視窗。 請注意,主控台中的每個 MDI 視窗都代表不同的檢視,而且 MDI 視窗內的嵌入式管理單元實例會對應至該嵌入式管理單元的 IComponent 物件。
因此,嵌入式管理單元應該只在與IComponent物件相關聯的IConsole2介面指標上呼叫這個方法,也就是說,在IComponent::Initialize所傳回的 IConsole介面指標上呼叫QueryInterface所擷取的IConsole2介面指標。
若要列舉命名空間中專案的子專案,而不需明確展開專案,嵌入式管理單元應該使用 IConsoleNameSpace2::Expand 方法。
需求
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | mmc.h |
Dll | Mmcndmgr.dll |