Método ISearchNotifyInlineSite::OnCatalogStatusChange (searchapi.h)
Chamado pelo serviço de pesquisa para notificar um cliente quando o status do catálogo for alterado.
Sintaxe
HRESULT OnCatalogStatusChange(
[in] REFGUID guidCatalogResetSignature,
[in] REFGUID guidCheckPointSignature,
[in] DWORD dwLastCheckPointNumber
);
Parâmetros
[in] guidCatalogResetSignature
Tipo: REFGUID
Um GUID que representa a redefinição de catálogo. Se esse GUID for alterado, todas as notificações deverão ser ressentidas.
[in] guidCheckPointSignature
Tipo: REFGUID
Um GUID que representa o último ponto de verificação restaurado. Se esse GUID for alterado, todas as notificações acumuladas desde o último ponto de verificação salvo deverão ser reenviadas.
[in] dwLastCheckPointNumber
Tipo: DWORD
Um número que indica o último ponto de verificação salvo.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Quando ocorre um ponto de verificação de catálogo, o serviço de pesquisa atualiza o dwLastCheckPointNumber e todas as notificações enviadas antes desse ponto de verificação são seguras e recuperáveis em caso de falha de serviço. Os provedores de notificação precisam acompanhar apenas as notificações enviadas entre pontos de verificação e devem reenviar se o catálogo for restaurado ou redefinido.
Se ocorrer uma restauração de catálogo, o serviço de pesquisa reverterá o catálogo para o último ponto de verificação salvo e atualizará o guidCheckPointSignature. Nessa situação, os provedores de notificação devem reenviar todas as notificações acumuladas desde o ponto de verificação salvo mais recente, conforme identificado pelo parâmetro dwLastCheckPointNumber .
Se ocorrer uma redefinição de catálogo, o serviço de pesquisa redefinirá todo o catálogo e atualizará guidCatalogResetSignature. O provedor de notificação deve reenviar todo o escopo de rastreamento.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | searchapi.h |
| Redistribuível | Pesquisa da Área de Trabalho do Windows (WDS) 3.0 |