IResultData interface (mmc.h)

The IResultData interface enables a user to add, remove, find, and modify items associated with the result view pane. It also enables the manipulation of the view style of the result view pane.

The IResultData interface was designed to give the impression that the result view pane would be used by only one component, but components should be aware that the result view pane can, in fact, be shared by several components. All item manipulations are performed through the use of an item ID assigned when the item is inserted. This ID is guaranteed to be both static and unique for the life of the item. When an item is deleted, the ID is freed and can be used by other new items in the list. You should never keep an item ID around after its associated item has been deleted.

The IResultData interface handles virtual (owner data) lists as well. Because of the nature of virtual lists, not all methods apply and some methods have limited functionality. These differences are detailed in the descriptions of individual methods. The primary difference in handling virtual lists it that because the console does not maintain any storage for virtual items, it does not provide item IDs. Instead virtual list items are identified by their list position (index).

Inheritance

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

Methods

The IResultData interface has these methods.

 
IResultData::DeleteAllRsltItems

The IResultData::DeleteAllRsltItems method enables the snap-in to remove all user-inserted items and subitems from the result view pane.
IResultData::DeleteItem

Enables the snap-in to delete a single item in the result view pane.
IResultData::FindItemByLParam

The IResultData::FindItemByLParam method enables the snap-in to find an item or subitem based on its user-inserted lParam value.
IResultData::GetItem

Enables a user to retrieve the parameters of a single item.
IResultData::GetNextItem

The IResultData::GetNextItem method gets the next item in the result view with the specified state flags set.
IResultData::GetViewMode

Enables the snap-in to retrieve a view mode for the result view pane.
IResultData::InsertItem

The IResultData::InsertItem method enables the snap-in to add a single new item to the result pane view.
IResultData::ModifyItemState

Enables the snap-in to modify the state of an item.
IResultData::ModifyViewStyle

The IResultData::ModifyViewStyle method enables the snap-in to set the result pane's view style.
IResultData::SetDescBarText

Sets the description bar text for the result view pane.
IResultData::SetItem

The IResultData::SetItem method enables the snap-in to set a single item in the result pane.
IResultData::SetItemCount

Sets the number of items in a virtual list.
IResultData::SetViewMode

Enables the snap-in to set the view mode in which the result view pane displays its items.
IResultData::Sort

Sorts all items in the result pane.
IResultData::UpdateItem

Causes a specified item in the result pane to be redrawn.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header mmc.h