Método ISearchPersistentItemsChangedSink::StartedMonitoringScope (searchapi.h)

Chamado por um provedor de notificações para notificar o indexador para monitorar alterações em itens dentro de um escopo hierárquico especificado.

Sintaxe

HRESULT StartedMonitoringScope(
  [in] LPCWSTR pszURL
);

Parâmetros

[in] pszURL

Tipo: LPCWSTR

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que é o endereço inicial para o escopo a ser monitorado.

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 perda de notificação, um agente de notificação fica online e chama StartedMonitoringScope, que permite que uma fonte de notificação gerenciada por índice se adicione a uma lista de "escopos monitorados". O indexador inicia um rastreamento incremental do repositório de documentos correspondente. O indexador rastreia esses escopos incrementalmente até que as condições extremas que causaram a perda de notificações não estejam mais presentes. Esse método garante que todas as alterações no repositório que ocorrem durante um período de perda de notificação sejam detectadas.

Em circunstâncias normais, a lista de escopos monitorados não é usada. A perda de notificação é rara e geralmente ocorre apenas quando o espaço em disco é extremamente baixo.

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