Metodo ISearchPersistentItemsChangedSink::StartedMonitoringScope (searchapi.h)

Chiamato da un provider di notifiche per notificare all'indicizzatore di monitorare le modifiche agli elementi all'interno di un ambito gerarchico specificato.

Sintassi

HRESULT StartedMonitoringScope(
  [in] LPCWSTR pszURL
);

Parametri

[in] pszURL

Tipo: LPCWSTR

Puntatore a una stringa Unicode con terminazione null che rappresenta l'indirizzo iniziale per il monitoraggio dell'ambito.

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 una perdita di notifica, un agente di notifica viene online e chiama StartedMonitoringScope, che consente a un'origine di notifica gestita dall'indice di aggiungersi a un elenco di "ambiti monitorati". L'indicizzatore avvia una ricerca per indicizzazione incrementale dell'archivio documenti corrispondente. L'indicizzatore esegue la ricerca per indicizzazione di questi ambiti in modo incrementale fino a quando le condizioni estreme che hanno causato la perdita di notifiche non sono più presenti. Questo metodo garantisce che vengano rilevate eventuali modifiche nell'archivio che si verificano durante un periodo di perdita di notifica.

In circostanze normali, l'elenco degli ambiti monitorati non viene usato. La perdita di notifica è rara e in genere si verifica solo quando lo spazio su disco è estremamente basso.

Requisiti