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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP2, Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | searchapi.h |
| Verteilbare Komponente | Windows Desktop Search (WDS) 3.0 |