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 |