IGatherNotify (Deprecated) interface
[IGatherNotify may be altered or unavailable in subsequent versions of the operating system or product.]
This Windows Desktop Search interface topic is deprecated and is superseded by the Windows Search ISearchPersistentItemsChangedSink API in the Windows SDK.
This interface is used by protocol handlers to add URLs or start pages to the list of things to be indexed. It is also used to notify the indexer when an item has been changed or moved. This is helpful for applications such as Microsoft Outlook, where the protocol handler is monitoring the store and notifying the indexer of changed items that require indexing. This way the indexer does not crawl the entire store on incremental indexes. This object should be created only when the indexer is running.
A typical call sequence: check to ensure that the indexer is running, create the object, call IGatherNotify::Init, call IGatherNotify repeatedly (as needed), call IGatherNotify::OnDataChange or IGatherNotify::OnDataMove repeatedly (as needed), call IGatherNotify::RemoveScope repeatedly (as needed), and remove the object.
Members
The IGatherNotify (Deprecated) interface inherits from the IUnknown interface. IGatherNotify (Deprecated) also has these types of members:
- Methods
Methods
The IGatherNotify (Deprecated) interface has these methods.
Method | Description |
---|---|
AddScope | This Windows Desktop Search interface topic is deprecated and is superseded by the Windows Search ISearchPersistentItemsChangedSink API in the Windows SDK. Adds the start page or URL you are monitoring. This initiates an incremental crawl when you connect, and then assumes all further URL changes are by notification. |
Init | This Windows Desktop Search interface topic is deprecated and is superseded by the Windows Search ISearchPersistentItemsChangedSink API in the Windows SDK. Initializes the Gatherer interface. Also specifies the index to notify and the application store to monitor. |
OnDataChange | This Windows Desktop Search interface topic is deprecated and is superseded by the Windows Search ISearchPersistentItemsChangedSink API in the Windows SDK. This method notifies the indexer of data that has changed. When it sends the notification to the indexer, it includes the type of change, physical address, and logical address. |
OnDataMove | This Windows Desktop Search interface topic is deprecated and is superseded by the Windows Search ISearchPersistentItemsChangedSink API in the Windows SDK. This method notifies the indexer of data that has been moved. When it sends the notification to the indexer, it includes the old address, new address, and logical address. |
RemoveScope | This Windows Desktop Search interface topic is deprecated and is superseded by the Windows Search ISearchPersistentItemsChangedSink API in the Windows SDK. This method notifies the indexer that the start page or URL is no longer being monitored. |
Requirements
Minimum supported client |
Windows XP with SP2, Windows Vista [desktop apps only] |
Minimum supported server |
Windows Server 2003 with SP1 [desktop apps only] |
Redistributable |
Windows Desktop Search (WDS) 2.6.5 |
Header |
Searchapi.h |