[This is preliminary documentation and subject to change.]
The IComponentData interface enables the Microsoft® Management Console (MMC) to communicate with snap-in components. 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.
Implement IComponentData in your in-proc server DLL to communicate with the console's Node Manager. It enumerats a snap-in'sdynamic scope pane items (called folders). It is also displays information for the scope items.
The IComponentData interface is required for any snap-in component that enumerates items in the master namespace (scope pane). Extension snap-ins that do not extend the namespace (but extend other features like context menus, toolbars, and so on) do not need to implement this interface or the IComponent interface.
| IUnknown Methods | Description |
|---|---|
| QueryInterface | Returns pointers to supported interfaces. |
| AddRef | Increments reference count. |
| Release | Decrements reference count. |
| IComponentData Methods | Description |
|---|---|
| Initialize | Provides an entry point to the console. |
| CreateComponent | Creates a component that will be associated with this IComponentData. |
| Notify | Console calls to notify the snap-in of actions taken by a user. |
| Destroy | Release all references to the console. |
| QueryDataObject | Returns a data object that can be used to retrieve context information for the cookie. |
| GetDisplayInfo | Retrieves display information for an item in the scope pane. |
| CompareObjects | Enables a snap-in to compare two data objects acquired through QueryDataObject. Note that data objects can be acquired from two different instances of IComponentData. |