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

Vedi anche

ISearchNotifyInlineSite

Notifica dell'indice delle modifiche