IRequestFilteredSync::SpecifyFilter method (winsync.h)
When implemented by a derived class, negotiates which filter is used by the source provider during change enumeration.
HRESULT SpecifyFilter( [in] IFilterRequestCallback *pCallback );
The callback interface that is used by the destination provider to request that a filter be used by the source provider during change enumeration.
The possible return codes include, but are not limited to, the values shown in the following table.
||The method succeeded.|
Filter negotiation is achieved by using the following steps:
- Before the source provider begins enumerating changes, a synchronization session typically starts filter negotiation by calling IRequestFilteredSync::SpecifyFilter on the destination provider.
- During processing of IRequestFilteredSync::SpecifyFilter, the destination provider passes filters to IFilterRequestCallback::RequestFilter.
- During processing of IFilterRequestCallback::RequestFilter, a synchronization session typically calls ISupportFilteredSync::AddFilter on the source provider. If the source provider does not support the requested filter, the destination provider can continue to request filters until it finds one that is supported.
When ISupportFilteredSync::AddFilter returns an error other than SYNC_E_FILTER_NOT_SUPPORTED, IRequestFilteredSync::SpecifyFilter should return the error to the Sync Application. This ends the synchronization session.
|Minimum supported client||Windows 7 [desktop apps only]|
|Minimum supported server||Windows Server 2008 R2 [desktop apps only]|