IComponentData interface

The IComponentData interface enables MMC to communicate with snap-ins. Similar to the IComponent interface, IComponentData is typically implemented at the document level and is closely associated with items (folders) being displayed in the scope pane.

When to implement

Implement IComponentData in your in-process server DLL to communicate with the console's Node Manager. It enumerates a snap-in's dynamic scope items (also called folders). It also displays information for the scope items.

When to use

The IComponentData interface is required for any snap-in that enumerates items in the master namespace (scope pane). IComponentData is also required for persistence. See Snap-in Persistence Model for details about persistence.

Generally, extension snap-ins that do not extend the namespace (but extend other features like context menus, toolbars, and so on) need not implement this interface. The only exception to this is in the case of persisted data, for which IComponentData is required. Only namespace and taskpad extensions may have persisted data.

Members

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

Methods

The IComponentData interface has these methods.

MethodDescription
CompareObjects

Enables a snap-in to compare two data objects acquired through QueryDataObject. Be aware that data objects can be acquired from two different instances of IComponentData.

CreateComponent

Creates a component that will be associated with this IComponentData.

Destroy

Releases all references to the console.

GetDisplayInfo

Retrieves display information about an item in the scope pane.

Initialize

Provides an entry point to the console.

Notify

Called by the console to notify the snap-in of actions taken by a user.

QueryDataObject

Returns a data object that can be used to retrieve context information for the specified cookie.

 

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Mmc.h

 

 

Show: