IFilterRequestCallback::RequestFilter

Article
10/17/2009

Demande que le filtre fourni par le fournisseur de destination soit utilisé par le fournisseur de source pendant l'énumération des modifications.

HRESULT RequestFilter(
  IUnknown * pFilter,
  FILTERING_TYPE filteringType);

Paramètres

Terme	Définition
pFilter	[in] Filtre qui est spécifié par le fournisseur de destination. Ce filtre est passé au fournisseur de source à utiliser pendant l'énumération des modifications.
filteringType	[in] Indique le type d'informations incluses dans un lot de modifications pendant la synchronisation filtrée.

Valeur de retour

S_OK.
E_POINTER.
SYNC_E_FILTER_NOT_SUPPORTED lorsque le filtre spécifié par pFilter n'est pas pris en charge par le fournisseur de source. Cette valeur est également retournée lorsque le fournisseur de source n'implémente pas ISupportFilteredSync.

Notes

Pour négocier l'utilisation des filtres, procédez comme suit :

Avant que le fournisseur de source commence à énumérer les modifications, Sync Framework démarre la négociation des filtres en appelant IRequestFilteredSync::SpecifyFilter sur le fournisseur de destination.
Pendant le traitement de IRequestFilteredSync::SpecifyFilter, le fournisseur de destination passe des filtres à IFilterRequestCallback::RequestFilter.
Pendant le traitement de IFilterRequestCallback::RequestFilter, Sync Framework appelle ISupportFilteredSync::AddFilter sur le fournisseur de source. Si le fournisseur de source ne prend pas en charge le filtre demandé, le fournisseur de destination peut continuer à demander des filtres jusqu'à ce qu'il en trouve un pris en charge.

Lorsqu'un filtre a été négocié avec succès, le fournisseur de source l'utilise pour déterminer les éléments à inclure pendant l'énumération des modifications.

Voir aussi

Référence

Interface IFilterRequestCallback
Interface IRequestFilteredSync
Interface ISupportFilteredSync

Partager via