ISyncChangeBatchWithFilterKeyMap::GetLearnedFilterForgottenKnowledge
Gets the filter forgotten knowledge for the specified filter that the destination replica learns when the destination provider applies all the changes in this change batch.
Syntax
HRESULT GetLearnedFilterForgottenKnowledge(
ISyncKnowledge * pDestinationKnowledge,
IEnumItemIds * pNewMoveins,
DWORD dwFilterKey,
ISyncKnowledge ** ppLearnedFilterForgottenKnowledge);
Parameters
pDestinationKnowledge
[in] When the change batch contains prerequisite knowledge, a knowledge fragment is added to the returned learned filter forgotten knowledge only if pDestinationKnowledge contains the prerequisite knowledge for that fragment.pNewMoveins
[in] Identifies items in the destination replica that have recently moved into the filter. These items are excluded from the returned learned filter forgotten knowledge. This list must include all items that have a filter move-in version that is not contained in the made-with knowledge of the change batch.dwFilterKey
[in] The filter key of the filter that is associated with the returned learned filter forgotten knowledge.ppLearnedFilterForgottenKnowledge
[out] Returns the filter forgotten knowledge for the filter identified by dwFilterKey that the destination replica learns when the destination provider applies all the changes in this change batch.
Return Value
S_OK.
E_INVALIDARG when dwFilterKey is an invalid value.
E_OUTOFMEMORY.
E_POINTER.
SYNC_E_BATCH_NEEDS_FILTER_FORGOTTEN_KNOWLEDGE when the change batch does not contain filter forgotten knowledge for the specified filter.