[This is preliminary documentation and subject to change.]
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.
Even though the IResultData interface was designed to give the impression that the result view pane would be used by only one component, 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 that is assigned when the item is inserted. This ID is guaranteed to be both static and unique for the life of the item. After an item is deleted, the ID is freed and may be used by other new items in the list. You should never keep an item ID around after its associated item has been deleted.
You do not implement the IResultData interface. It is implemented by the node manager in Microsoft Management Console.
You can use IResultData to allow the user of your snap-in component to change items in the result view pane or when the user decides to change the result pane's view style.
IUnknown Methods | Description |
---|---|
QueryInterface | Returns pointers to supported interfaces. |
AddRef | Increments reference count. |
Release | Decrements reference count. |
IResultData Methods | Description | |
---|---|---|
InsertItem | The snap-in can insert a single item. | |
DeleteItem | The snap-in can delete one item. | |
FindItemByLParam | The snap-in can find an item or subitem based on a user-inserted value. | |
DeleteAllRsltItems | The snap-in can delete all items. | |
SetItem | The snap-in can set a single item. | |
GetItem | The snap-in can retrieve a single item. | |
GetNextItem | Returns the lParam of the first item. | |
ModifyItemState | The snap-in can modify the item's state. | |
ModifyViewStyle | The snap-in can set the result view style. | |
SetViewMode | The snap-in can set the result view mode. | |
GetViewMode | The snap-in can retrieve the result view mode. | |
UpdateItem | Redraws an item in the result pane after it has been changed. | |
Sort | Sorts all result pane items. | |
SetDescBarText | Sets result view description bar text. | |
SetItemCount |