IConsole2::SelectScopeItem method
The IConsole2::SelectScopeItem method selects the given scope item.
Syntax
HRESULT SelectScopeItem(
[in] HSCOPEITEM hScopeItem
);
Parameters
- hScopeItem [in]
A handle to the item in the scope pane to be selected.
Return value
This method can return one of these values.
S_OK
The specified scope item was selected.E_UNEXPECTED
An unexpected error occurred.E_FAIL
hScopeItem is not a valid scope item belonging to the current snap-in.
Remarks
Use this method to reselect the currently selected scope item or to select another scope item.
You can have a single scope item with several different views available, for example, several OLE custom control (OCX) views and the default list view. When the user selects a different view from a menu, the snap-in receives the command and should then call SelectScopeItem to reselect the item. IComponent::GetResultViewType can then return the new view type.
If SelectScopeItem is called by the snap-in in its MMCN_EXPAND notification handler, MMC will not select the specified scope item, even though SelectScopeItem may return S_OK.
Requirements
Minimum supported client |
Windows Vista |
Minimum supported server |
Windows Server 2008 |
Header |
Mmc.h |
DLL |
Mmcndmgr.dll |