Share via

ISyncChangeWithFilterKeyMap::GetLearnedFilterForgottenKnowledge

  • Article

Gets the filter forgotten knowledge for the specified filter that the destination replica learns when the destination provider applies this change.

Syntax

HRESULT GetLearnedFilterForgottenKnowledge(
  ISyncKnowledge *  pDestinationKnowledge,
  IEnumItemIds   *  pNewMoveins,
  DWORD             dwFilterKey,
  ISyncKnowledge ** ppLearnedFilterForgottenKnowledge);

Parameters

  • pDestinationKnowledge
    [in] When the change 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.

  • 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 this change.

Return Value

  • S_OK.

  • E_INVALIDARG when dwFilterKey is an invalid value.

  • E_OUTOFMEMORY.

  • E_POINTER.

  • SYNC_E_BATCH_NEEDS_FILTER_FORGOTTEN_KNOWLEDGE when filter forgotten knowledge does not exist for the specified filter.

See Also

Reference

ISyncChangeWithFilterKeyMap Interface