IRowsetEvents インターフェイス (searchapi.h)
イベント通知を受信するためのメソッドを公開します。 クライアントがこのインターフェイスを実装すると、インデクサーは、新しい項目の追加、アイテムの削除、アイテム データの変更など、行セット内の項目に対する変更をクライアントに通知できます。
継承
IRowsetEvents インターフェイスは、IUnknown インターフェイスから継承されます。 IRowsetEvents には、 次の種類のメンバーもあります。
メソッド
IRowsetEvents インターフェイスには、これらのメソッドがあります。
| IRowsetEvents::OnChangedItem アイテムが変更されたことをクライアントに通知するために、インデクサーによって呼び出されます。 この項目は、クライアント行セットの条件の一部 (またはすべて) と一致している可能性があります。 |
| IRowsetEvents::OnDeletedItem アイテムが削除されたことをクライアントに通知するために、インデクサーによって呼び出されます。 この項目は、クライアント行セットの検索条件の一部 (またはすべて) と一致している可能性があります。 |
| IRowsetEvents::OnNewItem インデクサーによって呼び出され、クライアント行セットの条件の一部 (またはすべて) に一致する可能性がある新しい項目がクライアントに通知されます。 |
| IRowsetEvents::OnRowsetEvent インデクサーによって呼び出され、クライアント行セットに関連するイベントがクライアントに通知されます。 |
解説
実装するタイミング
プロバイダーが行セット イベントの通知を受信する必要がある場合は、 IRowsetEvents を実装します。 IRowsetEvents はイベント通知を受信するためのメソッドを公開し、イベントに対する次の通知を受け取るために実装する必要があります: OnChangedItem、 OnDeletedItem、 OnNewItem 、 OnRowsetEvent。 ROWSETEVENT_ITEMSTATE列挙子とROWSETEVENT_TYPE列挙子は、それぞれ項目の状態と行セット イベントをキャプチャします。インデクサー イベントは、プロバイダーが行セットで通知を受信できるようにする Windows 7 の新機能です。 プロバイダーはイベント処理を使用して、実際のファイル システムの場所と同様に動作するように行セットを維持できます。
IRowsetEvents インターフェイスは、開いているインデクサー行セットを持つ接続ポイントによって登録されます。
行セット イベントを使用するには、クエリを実行する前に OLE DB ICommandProperties::SetProperties メソッドを使用して、DBPROP_ENABLEROWSETEVENTSを TRUE に設定する必要があります。
要件
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | searchapi.h |
関連項目
概念
Windows 7 での優先度設定イベントと行セット イベントのインデックス作成
リファレンス