Método ISearchNotifyInlineSite::OnCatalogStatusChange (searchapi.h)
Llamado por el servicio de búsqueda para notificar a un cliente cuando cambia el estado del catálogo.
Sintaxis
HRESULT OnCatalogStatusChange(
[in] REFGUID guidCatalogResetSignature,
[in] REFGUID guidCheckPointSignature,
[in] DWORD dwLastCheckPointNumber
);
Parámetros
[in] guidCatalogResetSignature
Tipo: REFGUID
GUID que representa el restablecimiento del catálogo. Si este GUID cambia, todas las notificaciones deben volver a enviarse.
[in] guidCheckPointSignature
Tipo: REFGUID
GUID que representa el último punto de control restaurado. Si este GUID cambia, todas las notificaciones acumuladas desde el último punto de control guardado deben volver a enviarse.
[in] dwLastCheckPointNumber
Tipo: DWORD
Número que indica el último punto de control guardado.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Cuando se produce un punto de control de catálogo, el servicio de búsqueda actualiza dwLastCheckPointNumber y todas las notificaciones enviadas antes de ese punto de control son seguras y recuperables en caso de error de servicio. Los proveedores de notificaciones solo deben realizar un seguimiento de las notificaciones enviadas entre puntos de control y deben volver a enviarlas si el catálogo se restaura o restablece.
Si se produce una restauración de catálogo, el servicio de búsqueda revierte el catálogo al último punto de control guardado y actualiza guidCheckPointSignature. En esta situación, los proveedores de notificaciones deben volver a enviar todas las notificaciones acumuladas desde el punto de control guardado más reciente, como se identifica en el parámetro dwLastCheckPointNumber .
Si se produce un restablecimiento de catálogo, el servicio de búsqueda restablece todo el catálogo y actualiza guidCatalogResetSignature. El proveedor de notificaciones debe reenviar todo su ámbito de rastreo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | searchapi.h |
| Redistribuible | Búsqueda de escritorio de Windows (WDS) 3.0 |