Metodo ISearchNotifyInlineSite::OnCatalogStatusChange (searchapi.h)
Chiamato dal servizio di ricerca per notificare a un client quando lo stato del catalogo cambia.
Sintassi
HRESULT OnCatalogStatusChange(
[in] REFGUID guidCatalogResetSignature,
[in] REFGUID guidCheckPointSignature,
[in] DWORD dwLastCheckPointNumber
);
Parametri
[in] guidCatalogResetSignature
Tipo: REFGUID
GUID che rappresenta la reimpostazione del catalogo. Se questo GUID viene modificato, tutte le notifiche devono essere reinviate.
[in] guidCheckPointSignature
Tipo: REFGUID
GUID che rappresenta l'ultimo checkpoint ripristinato. Se questo GUID cambia, tutte le notifiche accumulate dopo l'ultimo checkpoint salvato devono essere reinviate.
[in] dwLastCheckPointNumber
Tipo: DWORD
Numero che indica l'ultimo checkpoint salvato.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Quando si verifica un checkpoint del catalogo, il servizio di ricerca aggiorna dwLastCheckPointNumber e tutte le notifiche inviate prima di tale checkpoint sono sicure e recuperabili in caso di errore del servizio. I provider di notifiche devono tenere traccia solo delle notifiche inviate tra checkpoint e devono inviarle di nuovo se il catalogo viene ripristinato o reimpostato.
Se si verifica un ripristino del catalogo, il servizio di ricerca esegue il rollback del catalogo all'ultimo checkpoint salvato e aggiorna il guidCheckPointSignature. In questo caso, i provider di notifiche devono inviare nuovamente tutte le notifiche accumulate dopo il checkpoint salvato più recente, come identificato dal parametro dwLastCheckPointNumber .
Se si verifica una reimpostazione del catalogo, il servizio di ricerca reimposta l'intero catalogo e aggiorna il guidCatalogResetSignature. Il provider di notifica deve inviare nuovamente l'intero ambito di ricerca per indicizzazione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP con SP2, Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | searchapi.h |
| Componente ridistribuibile | Windows Desktop Search (WDS) 3.0 |