IRequestFilteredSync::SpecifyFilter method (winsync.h)

When implemented by a derived class, negotiates which filter is used by the source provider during change enumeration.

Syntax

HRESULT SpecifyFilter(
  [in] IFilterRequestCallback *pCallback
);

Parameters

[in] 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.

Return value

The possible return codes include, but are not limited to, the values shown in the following table.

Return code Description
S_OK
The method succeeded.
Provider-determined error codes.

Remarks

Filter negotiation is achieved by using the following steps:

  1. Before the source provider begins enumerating changes, a synchronization session typically starts filter negotiation by calling IRequestFilteredSync::SpecifyFilter on the destination provider.
  2. During processing of IRequestFilteredSync::SpecifyFilter, the destination provider passes filters to IFilterRequestCallback::RequestFilter.
  3. 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 a filter has been successfully negotiated, the source provider uses it to determine which items to include during change enumeration.
Note  An implementation of this method can repeatedly call IFilterRequestCallback::RequestFilter until a filter is found that is supported by both the destination provider and the source provider. The source provider indicates that it does not support a filter by returning SYNC_E_FILTER_NOT_SUPPORTED in response to the ISupportFilteredSync::AddFilter call.

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.

 

Requirements

   
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header winsync.h

See also

IFilterRequestCallback Interface

IRequestFilteredSync Interface

ISupportFilteredSync Interface