IFilterTrackingSaveChangeContext::GetFilterChange
Obtient des informations qui indiquent si cette modification a pour effet de déplacer l'élément dans ou hors d'un filtre spécifié.
HRESULT GetFilterChange(
DWORD dwFilterKey,
SYNC_FILTER_CHANGE * pFilterChange);
Paramètres
- dwFilterKey
[in] Clé qui identifie le filtre dans le mappage de clés de filtre du réplica de destination.
- pFilterChange
[out] Retourne des informations qui indiquent si cette modification a pour effet d'inclure l'élément dans le filtre identifié par dwFilterKey ou de l'en exclure.
Valeur de retour
S_OK.
S_FALSE lorsque le fournisseur de source n'effectue pas le suivi du filtre spécifié.
E_INVALIDARG lorsque dwFilterIndex est une valeur non valide.
E_POINTER.
Notes
Une modification peut provoquer le déplacement d'un élément dans ou hors d'un filtre. Par exemple, les éléments contiennent un champ state, et un filtre exclut tout élément dont le champ state est égal à « Washington ». Lorsqu'un élément dont state est égal à « Washington » change de sorte que state soit égal à « Oregon », l'élément se déplace dans le filtre.
Un fournisseur de destination représentant un réplica qui effectue le suivi des filtres doit appeler cette méthode pour récupérer les informations mises à jour relatives à chaque modification qui est appliquée au réplica de destination.