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 エラー コードを返します。

注釈

rowsetItemState のROWSETEVENT_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

リファレンス

行セット プロパティ