ISearchNotifyInlineSite::OnCatalogStatusChange-Methode (searchapi.h)

Wird vom Suchdienst aufgerufen, um einen Client zu benachrichtigen, wenn sich die status des Katalogs ändert.

Syntax

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

Parameter

[in] guidCatalogResetSignature

Typ: REFGUID

Eine GUID, die die Katalogzurücksetzung darstellt. Wenn sich diese GUID ändert, müssen alle Benachrichtigungen erneut angezeigt werden.

[in] guidCheckPointSignature

Typ: REFGUID

Eine GUID, die den zuletzt wiederhergestellten Prüfpunkt darstellt. Wenn sich diese GUID ändert, müssen alle Benachrichtigungen, die seit dem letzten gespeicherten Prüfpunkt gesammelt wurden,erneutt werden.

[in] dwLastCheckPointNumber

Art: DWORD

Eine Zahl, die den zuletzt gespeicherten Prüfpunkt angibt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn ein Katalogprüfpunkt auftritt, aktualisiert der Suchdienst dwLastCheckPointNumber, und alle Benachrichtigungen, die vor diesem Prüfpunkt gesendet werden, sind sicher und wiederherstellbar im Falle eines Dienstfehlers. Benachrichtigungsanbieter müssen nur die zwischen Prüfpunkten gesendeten Benachrichtigungen nachverfolgen und sie erneut senden, wenn der Katalog wiederhergestellt oder zurückgesetzt wird.

Wenn eine Katalogwiederherstellung erfolgt, führt der Suchdienst ein Rollback für den Katalog auf den zuletzt gespeicherten Prüfpunkt und aktualisiert guidCheckPointSignature. In dieser Situation müssen Benachrichtigungsanbieter alle Benachrichtigungen erneut senden, die seit dem zuletzt gespeicherten Prüfpunkt kumuliert wurden, wie durch den dwLastCheckPointNumber-Parameter identifiziert.

Wenn eine Katalogzurücksetzung erfolgt, setzt der Suchdienst den gesamten Katalog zurück und aktualisiert guidCatalogResetSignature. Der Benachrichtigungsanbieter muss den gesamten Durchforstungsbereich erneut senden.

Anforderungen

Weitere Informationen

ISearchNotifyInlineSite

Benachrichtigen des Indexes über Änderungen