Pemberitahuan Indeks Perubahan (Fitur-Fitur Lingkungan Windows Lama)
Nota
Windows Desktop Search 2.x adalah teknologi usang yang awalnya tersedia sebagai add-in untuk Windows XP dan Windows Server 2003. Pada rilis selanjutnya, gunakan Windows Search.
Dengan Microsoft Windows Desktop Search (WDS) 2.6, penangan protokol untuk penyimpanan data tertentu dapat memberi tahu Pengindeks WDS ketika data di penyimpanan mereka telah berubah. Ini meningkatkan performa dengan memastikan Pengindeks tidak merayapi seluruh penyimpanan pada indeks bertambah bertahap. Dengan menggunakan API pemberitahuan, pengendali protokol dapat memberi tahu Pengindeks bahwa item telah dipindahkan atau dihapus, dan mereka dapat menambahkan cakupan ke antrean URL WDS Indexer yang memerlukan pengindeksan. Pemberitahuan berguna untuk aplikasi seperti email, di mana handler protokol memantau penyimpanan dan memberi tahu Pengindeks bahwa item telah berubah dan memerlukan pengindeksan.
(If translatable) "SinkPerubahanItemPencarian" (Note: Ensure whether this term is common in the industry and needs localization)
Penangan protokol memberi tahu Pengindeks perubahan melalui antarmuka ISearchItemsChangedSink. Informasi tentang perubahan data harus dikumpulkan dalam struktur SEARCH_ITEM_CHANGE dan enumerasi jenis SEARCH_KIND_OF_CHANGE, kemudian dikomunikasikan ke Pengindeks melalui metode OnItemsChanged dari antarmuka ISearchItemsChangedSink.
Untuk mengakses antarmuka ini, handler protokol kustom harus terlebih dahulu membuat instans objekISearchManageruntuk mendapatkan akses ke objek ISearchCatalogManager. Dari sana, seseorang dapat membuat instans objek ISearchItemsChangedSink dan memberi tahu Pengindeks perubahan data.
Metode OnItemsChanged memungkinkan Anda mengumpulkan dan mengomunikasikan perubahan data ke penyimpanan data pelanggan Anda untuk memulai pengindeksan.
| Arah | Variabel | Deskripsi |
|---|---|---|
| Di | dwNumberofChanges | Jumlah total perubahan dalam pemberitahuan. |
| Di | EntriPerubahanData[] | Semua pemberitahuan perubahan dalam suatu array struktur SEARCH_ITEM_CHANGE. |
| Keluar | dwBatchId | ID batch yang akan diteruskan kembali bersama pesan kesalahan. |
| Keluar | KodePenyelesaianHR[] | Menunjukkan apakah setiap URL diterima untuk pengindeksan. |
Struktur SEARCH_ITEM_CHANGE mengidentifikasi jenis perubahan yang terjadi serta URL item saat ini dan URL sebelumnya, jika berlaku. Struktur didefinisikan sebagai berikut:
| Nama Properti | Tipe Properti | Deskripsi |
|---|---|---|
| Ubah | CARI_JENIS_PERUBAHAN | Jenis perubahan yang diberitahukan. |
| URL | LPWSTR | URL untuk objek yang telah berubah. |
| URL Lama | LPWSTR | Jika pemberitahuan adalah pemindahan, URL lama disediakan dan harus unik. |
| Prioritas | PRIORITAS_PEMBERITAHUAN_PENCARIAN | Prioritas perubahan. |
Enumerasi SEARCH_KIND_OF_CHANGE didefinisikan sebagai berikut:
| Nilai Enum | Nilai | Deskripsi |
|---|---|---|
| CARI_UBAH_TAMBAH | 0 | Pemberitahuan ini untuk URL tambahan. |
| CARI_UBAH_HAPUS | 1 | Pemberitahuan adalah untuk penghapusan URL. |
| CARI_UBAH_MODIFIKASI | 2 | Pemberitahuannya adalah bahwa URL telah dimodifikasi. |
| CARI_UBAH_PINDAH_GANTI_NAMA | 3 | Pemberitahuan adalah untuk memindahkan dan mengganti nama objek ke URL baru. |
| PENCARIAN_UBAH_SEMANTIK_DIREKTORI | 0x10000 | Pemberitahuan ini untuk URL kontainer. |
| PENCARIAN_UBAH_SEMANTIK_SEMENTARA | 0x20000 | Pemberitahuan adalah untuk URL kontainer yang seharusnya hanya mengindeks properti kontainernya. |
| Perubahan Semantik Pencarian Keamanan | 0x40000 | Pemberitahuan adalah untuk URL atau URL kontainer yang telah mengubah properti keamanannya. |
Enumerasi SEARCH_NOTIFICATION_PRIORITY didefinisikan sebagai berikut:
| Nilai Enum | Nilai | Deskripsi |
|---|---|---|
| SEARCH_NORMAL_PRIORITY | 0 | Hanya prioritas normal yang harus digunakan saat mengindeks URL. Pemberitahuan ini diproses sebelum pengindeksan inkremental latar belakang normal file dan penyimpanan data milik pengguna. |