IRowsetEvents::OnChangedItem 方法 (searchapi.h)

由索引器呼叫,以通知用戶端已修改專案。 此專案可能符合客戶端資料列集的一些 (或所有) 準則。

語法

HRESULT OnChangedItem(
  [in] REFPROPVARIANT        itemID,
  [in] ROWSETEVENT_ITEMSTATE rowsetItemState,
  [in] ROWSETEVENT_ITEMSTATE changedItemState
);

參數

[in] itemID

類型: REFPROPVARIANT

指定數據列集中已變更的專案。

[in] rowsetItemState

類型: ROWSETEVENT_ITEMSTATE

指定變更的專案是否原本在數據列集中。

[in] changedItemState

類型: ROWSETEVENT_ITEMSTATE

指定變更的專案目前是否在數據列集中,因為變更所致。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

rowsetItemStateROWSETEVENT_ITEMSTATE指出專案是否包含在原始數據列集中:

  • ROWSETEVENT_ITEMSTATE_INROWSET 表示項目絕對包含在數據列集內。
  • ROWSETEVENT_ITEMSTATE_UNKNOWN 表示專案可能包含在您的數據列集內。 內含項目狀態未知,因為您的數據列集未完全評估。
  • ROWSETEVENT_ITEMSTATE_NOTINROWSET 指出專案原本不在數據列集中
changedItemState的ROWSETEVENT_ITEMSTATE指出新修改的項目現在是否符合新專案可能符合數據列集的原始搜尋準則的程度:
  • ROWSETEVENT_ITEMSTATE_INROWSET 表示項目絕對屬於數據列集。
  • ROWSETEVENT_ITEMSTATE_UNKNOWN 表示項目現在可能屬於您的數據列集。
  • ROWSETEVENT_ITEMSTATE_NOTINROWSET 表示項目不屬於數據列集。

規格需求

需求
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 searchapi.h

另請參閱

概念

IRowsetEvents

IRowsetPrioritization

在 Windows 7 中編制優先順序和數據列集事件的索引

PRIORITIZE_FLAGS

PRIORITY_LEVEL

ROWSETEVENT_ITEMSTATE

ROWSETEVENT_TYPE

參考

資料列集屬性