IFilterTrackingSyncChangeBuilder::AddFilterChange
Aggiunge informazioni che indicano se questa modifica determina lo spostamento dell'elemento all'interno o all'esterno di un filtro specificato.
HRESULT AddFilterChange(
DWORD dwFilterKey,
const SYNC_FILTER_CHANGE * pFilterChange);
Parametri
- dwFilterIndex
[in] Indice di un filtro nella mappa di chiavi dei filtri della replica.
- pFilterChange
[in] Informazioni sulla modifica in relazione al filtro specificato da dwFilterIndex.
Valore restituito
S_OK.
E_INVALIDARG se dwFilterIndex è un valore non valido.
E_OUTOFMEMORY.
E_POINTER.
SYNC_E_INVALID_OPERATION quando le informazioni sulle modifiche del filtro esistono già per dwFilterIndex.
Osservazioni
Una modifica può determinare lo spostamento di un elemento all'interno o all'esterno di un filtro. Ad esempio, gli elementi contengono un campo state e un filtro esclude qualsiasi elemento con il relativo campo state uguale a "Washington". Quando un elemento con state impostato su "Washington" viene modificato in modo che state sia uguale a "Oregon", l'elemento si sposta nel filtro.
Un provider che rappresenta una replica che rileva i filtri deve chiamare questo metodo per impostare le informazioni sul rilevamento dei filtri relative a ogni modifica enumerata.