ISearchPersistentItemsChangedSink::StartedMonitoringScope Method

Starts monitoring changes to items within a specified hierarchical scope.

Syntax

HRESULT StartedMonitoringScope(      
    LPCWSTR pszURL
);

Parameters

  • pszURL
    [in] The pointer to a null-terminated, Unicode string that is the start address for the scope being monitored.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

When a notification agent comes online, it calls ISearchPersistentItemsChangedSink::StartedMonitoringScope to add the scope to the list of sources. If the source is new (removed previously by ISearchPersistentItemsChangedSink::StoppedMonitoringScope or never created in the first place), the indexer starts an incremental crawl of the corresponding document store. This is designed to pick up any changes in the store that occurred while the notification agent was offline.