IFilterTrackingSaveChangeContext::GetFilterChange
Ruft Informationen ab, die angeben, ob das Element durch diese Änderung in einen oder aus einem angegebenen Filter verschoben wird.
HRESULT GetFilterChange(
DWORD dwFilterKey,
SYNC_FILTER_CHANGE * pFilterChange);
Parameter
- dwFilterKey
[in] Der Schlüssel, der den Filter in der Filterschlüsselzuordnung des Zielreplikats identifiziert.
- pFilterChange
[out] Gibt Informationen zurück, die angeben, ob durch diese Änderung ein Verschieben des Elements in den oder aus dem durch dwFilterKey identifizierten Filter verursacht wird.
Rückgabewert
S_OK.
S_FALSE, wenn der Quellenanbieter den angegebenen Filter nicht nachverfolgt.
E_INVALIDARG, wenn dwFilterIndex einen ungültigen Wert darstellt.
E_POINTER.
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 Zielanbieter, der ein Replikat darstellt, das Filter nachverfolgt, muss diese Methode aufrufen, um aktualisierte Informationen zu jeder Änderung abzurufen, die für das Zielreplikat übernommen wird.