Antarmuka IRowsetEvents (searchapi.h)

Artikel
03/15/2023

Mengekspos metode untuk menerima pemberitahuan peristiwa. Ketika klien menerapkan antarmuka ini, pengindeks dapat memberi tahu klien tentang perubahan pada item di set baris mereka: termasuk penambahan item baru, penghapusan item, dan modifikasi pada data item.

Warisan

Antarmuka IRowsetEvents mewarisi dari antarmuka IUnknown . IRowsetEvents juga memiliki jenis anggota ini:

Metode

Antarmuka IRowsetEvents memiliki metode ini.


IRowsetEvents::OnChangedItem Dipanggil oleh pengindeks untuk memberi tahu klien bahwa item telah dimodifikasi. Item ini mungkin telah cocok dengan beberapa (atau semua) kriteria untuk set baris klien.
IRowsetEvents::OnDeletedItem Dipanggil oleh pengindeks untuk memberi tahu klien bahwa item telah dihapus. Item ini mungkin telah cocok dengan beberapa (atau semua) kriteria pencarian untuk set baris klien.
IRowsetEvents::OnNewItem Dipanggil oleh pengindeks untuk memberi tahu klien tentang item baru yang mungkin cocok dengan beberapa (atau semua) kriteria untuk set baris klien.
IRowsetEvents::OnRowsetEvent Dipanggil oleh pengindeks untuk memberi tahu klien tentang peristiwa yang terkait dengan kumpulan baris klien.

Keterangan

Kapan harus Menerapkan

Terapkan IRowsetEvents jika penyedia Anda perlu menerima pemberitahuan peristiwa set baris. IRowsetEvents mengekspos metode untuk menerima pemberitahuan peristiwa, dan harus diimplementasikan untuk menerima pemberitahuan berikut tentang peristiwa: OnChangedItem, OnDeletedItem, OnNewItem , dan OnRowsetEvent. Enumerator ROWSETEVENT_ITEMSTATE dan ROWSETEVENT_TYPE mengambil status item dan peristiwa set baris.

Peristiwa pengindeks adalah fitur baru untuk Windows 7 yang memungkinkan penyedia untuk menerima pemberitahuan pada set baris mereka. Penyedia dapat menggunakan eventing untuk mempertahankan rowset mereka sia-sia sehingga mereka berkinerja mirip dengan lokasi sistem file yang sebenarnya.

Antarmuka IRowsetEvents didaftarkan oleh titik koneksi dengan rowset pengindeks terbuka.

DBPROP_ENABLEROWSETEVENTS harus diatur ke TRUE dengan metode OLE DB ICommandProperties::SetProperties sebelum menjalankan kueri untuk menggunakan peristiwa set baris.

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	searchapi.h