IRowsetEvents::OnChangedItem method (searchapi.h)
Called by the indexer to notify clients that an item has been modified. This item may have matched some (or all) of the criteria for the client rowset.
Syntax
HRESULT OnChangedItem(
[in] REFPROPVARIANT itemID,
[in] ROWSETEVENT_ITEMSTATE rowsetItemState,
[in] ROWSETEVENT_ITEMSTATE changedItemState
);
Parameters
[in] itemID
Type: REFPROPVARIANT
Specifies the item in the rowset that has changed.
[in] rowsetItemState
Type: ROWSETEVENT_ITEMSTATE
Specifies whether the changed item was originally in the rowset.
[in] changedItemState
Type: ROWSETEVENT_ITEMSTATE
Specifies whether the changed item is currently in the rowset, as a result of the change.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
The ROWSETEVENT_ITEMSTATE for rowsetItemState indicates whether the item was contained in the original rowset:
- ROWSETEVENT_ITEMSTATE_INROWSET indicates that the item is definitely contained within your rowset.
- ROWSETEVENT_ITEMSTATE_UNKNOWN indicates that the item may be contained within your rowset. The containment status is not known because your rowset is not fully evaluated.
- ROWSETEVENT_ITEMSTATE_NOTINROWSET indicates that the item was not originally in your rowset
- ROWSETEVENT_ITEMSTATE_INROWSET indicates that the item definitely belongs in your rowset.
- ROWSETEVENT_ITEMSTATE_UNKNOWN indicates that the item may now belong in your rowset.
- ROWSETEVENT_ITEMSTATE_NOTINROWSET indicates that the item does not belong in your rowset.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 7 [desktop apps only] |
| Minimum supported server | Windows Server 2008 R2 [desktop apps only] |
| Target Platform | Windows |
| Header | searchapi.h |
See also
Conceptual
Indexing Prioritization and Rowset Events in Windows 7
Reference