Metode ISearchNotifyInlineSite::OnCatalogStatusChange (searchapi.h)

Dipanggil oleh layanan pencarian untuk memberi tahu klien ketika status katalog berubah.

Sintaks

HRESULT OnCatalogStatusChange(
  [in] REFGUID guidCatalogResetSignature,
  [in] REFGUID guidCheckPointSignature,
  [in] DWORD   dwLastCheckPointNumber
);

Parameter

[in] guidCatalogResetSignature

Jenis: REFGUID

GUID yang mewakili reset katalog. Jika GUID ini berubah, semua pemberitahuan harus ditolak.

[in] guidCheckPointSignature

Jenis: REFGUID

GUID yang mewakili titik pemeriksaan terakhir yang dipulihkan. Jika GUID ini berubah, semua pemberitahuan yang terakumulasi sejak titik pemeriksaan terakhir yang disimpan harus dipulihkan.

[in] dwLastCheckPointNumber

Jenis: DWORD

Angka yang menunjukkan titik pemeriksaan terakhir disimpan.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Ketika titik pemeriksaan katalog terjadi, layanan pencarian memperbarui dwLastCheckPointNumber, dan semua pemberitahuan yang dikirim sebelum titik pemeriksaan tersebut aman dan dapat dipulihkan jika terjadi kegagalan layanan. Penyedia pemberitahuan hanya perlu melacak pemberitahuan yang dikirim di antara titik pemeriksaan dan harus mengirim ulang jika katalog dipulihkan atau direset.

Jika pemulihan katalog terjadi, layanan pencarian mengembalikan katalog ke titik pemeriksaan terakhir yang disimpan dan memperbarui guidCheckPointSignature. Dalam situasi ini, penyedia pemberitahuan harus mengirim ulang semua pemberitahuan yang terakumulasi sejak titik pemeriksaan tersimpan terbaru, seperti yang diidentifikasi oleh parameter dwLastCheckPointNumber .

Jika reset katalog terjadi, layanan pencarian mengatur ulang seluruh katalog dan memperbarui guidCatalogResetSignature. Penyedia pemberitahuan harus mengirim ulang seluruh cakupan perayapannya.

Persyaratan

Lihat juga

ISearchNotifyInlineSite

Memberi tahu Indeks Perubahan