IFilterTrackingNotifyingChangeApplierTarget::GetFilterForgottenKnowledge
When overridden in a derived class, gets the specified filter forgotten knowledge of the replica.
HRESULT GetFilterForgottenKnowledge(
DWORD dwFilterIndex,
ISyncKnowledge ** ppForgottenKnowledge);
Parameters
- dwFilterIndex
[in] The filter key of the filter that is associated with the filter forgotten knowledge to look up.
- ppForgottenKnowledge
[out] Returns the filter forgotten knowledge that is associated with the filter identified by dwFilterIndex. This value can be NULL when the filter forgotten knowledge is the same as the forgotten knowledge of the replica.
Return Value
S_OK.
Provider-determined error codes.
Remarks
A replica tracks a filter when it stores metadata that indicates whether an item is in the filter, and whether an item has been in the filter but has moved out. The replica might also contain filter forgotten knowledge for the filter, if it has removed metadata that tracks whether an item has been in the filter but has moved out, or if the replica does not track the filter the first time it synchronizes with a filtered replica and begins tracking the filter at a later time.