IResultData

[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.

When to Implement

You do not implement the IResultData interface. It is implemented by the node manager in Microsoft Management Console.

When to Use

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.

Methods in Vtable Order

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