IConsole::SelectScopeItem

[This is preliminary documentation and subject to change.]

Selects the given scope pane item.

HRESULT SelectScopeItem(
  HSCOPEITEM hScopeItem  // Handle to a scope item
);
 

Parameter

hScopeItem

[in] Handle of the item in the scope pane to be selected.

Return Values

S_OK

The specified scope item was selected.

E_UNEXPECTED

An unexpected error occurred.

E_FAIL

hScopeItem is neither the currently selected node, nor the parent or child of the currently selected node.

Remarks

Use this method to reselect the currently selected node, or select the parent or child of the currently selected node.

You can have a single scope node with several different views available, such as several OCX views and the default list view. When the user selects a different view from a menu, your snap-in receives the command and should then call SelectScopeItem to reselect the node. IComponent::GetResultViewType can then return the selected view type.

See Also

IComponent, IConsole