IFilterTrackingSyncChangeBuilder::AddFilterChange
Fügt Informationen hinzu, die angeben, ob das Element durch diese Änderung in einen oder aus einem angegebenen Filter verschoben wird.
HRESULT AddFilterChange(
DWORD dwFilterKey,
const SYNC_FILTER_CHANGE * pFilterChange);
Parameter
- dwFilterIndex
[in] Der Index eines Filters in der Filterschlüsselzuordnung des Replikats.
- pFilterChange
[in] Informationen zur Änderung bezüglich des in dwFilterIndex angegebenen Filters.
Rückgabewert
S_OK.
E_INVALIDARG, wenn dwFilterIndex einen ungültigen Wert darstellt.
E_OUTOFMEMORY.
E_POINTER.
SYNC_E_INVALID_OPERATION, wenn bereits Filteränderungsinformationen für dwFilterIndex vorhanden sind.
Hinweise
Durch eine Änderung kann ein Element in einen oder aus einem Filter verschoben werden. Elemente enthalten z. B. ein state-Feld, und ein Filter schließt jedes Element aus, dessen state-Feld gleich „Washington“ ist. Wenn ein Element mit state gleich „Washington“ geändert wird, sodass state gleich „Oregon“ ist, wird das Element in den Filter verschoben.
Ein Anbieter, der ein Replikat darstellt, das Filter nachverfolgt, muss diese Methode aufrufen, um Filternachverfolgungsinformationen zu jeder Änderung abzurufen, die enumeriert wird.