IConsole2 interface

The IConsole2 interface is introduced in MMC 1.1.

The IConsole2 interface enables communication with the console.

IConsole2 is the same as IConsole with the addition of the following methods:

When to implement

Do not implement IConsole2. It is implemented by the console Node Manager. A pointer to the IConsole2 interface is passed to the snap-in through IComponent::Initialize and IComponentData::Initialize. Each IComponent and IComponentData gets its own private IConsole2 interface pointer.

When to use

This interface enables snap-ins to communicate with the console.

When using IConsole2 for manipulating the result pane and result items, use the IConsole2 interface pointer passed to the snap-in's IComponent implementation that owns the view.

When using IConsole2 for manipulating the scope pane and scope items, use the IConsole2 interface pointer passed to snap-in's IComponentData implementation.

Members

The IConsole2 interface inherits from the IUnknown interface. IConsole2 also has these types of members:

Methods

The IConsole2 interface has these methods.

MethodDescription
Expand

Enables the snap-in to expand or collapse an item in the scope pane.

GetMainWindow

Returns a handle to the main frame window.

IsTaskpadViewPreferred

Determines whether the user prefers taskpad views by default.

MessageBox

Displays a message box.

NewWindow

Creates a new window rooted at the specified scope item.

QueryConsoleVerb

Query for the IConsoleVerb interface.

QueryResultImageList

Queries the console-provided result pane's image list.

QueryResultView

Queries IConsole for the result view object's IUnknown interface pointer.

QueryScopeImageList

Queries the console-provided scope pane's image list.

SelectScopeItem

Selects the given scope item.

SetHeader

Used by instances of IComponent only. Sets the header interface to be used for this IComponent.

SetStatusText

Enables the snap-in to change the text in the status bar.

SetToolbar

Used by instances of IComponent only. Sets the toolbar interface to be used for this IComponent.

UpdateAllViews

Generates a notification to update views because of content change.

 

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Mmc.h

DLL

Mmcndmgr.dll

 

 

Show: