Share via


IFilterTrackingSaveChangeContext::GetUpdatedFilterForgottenKnowledge

Gets the updated filter forgotten knowledge for the specified filter.

Syntax

HRESULT GetUpdatedFilterForgottenKnowledge(
  DWORD             dwFilterIndex,
  ISyncKnowledge ** ppFilterForgottenKnowledge);

Parameters

  • dwFilterIndex
    [in] The index that identifies the filter in the filter key map of the destination replica.

  • ppFilterForgottenKnowledge
    [out] Returns the filter forgotten knowledge for the specified filter.

Return Value

  • S_OK.

  • S_FALSE when the updated filter forgotten knowledge is NULL for the specified filter.

  • E_INVALIDARG when dwFilterIndex is an invalid value.

  • E_POINTER.

Remarks

A destination provider that represents a replica that tracks filters must call this method to retrieve updated information about each change that is applied to the destination replica. When ppFilterForgottenKnowledge returns a value that is not NULL, the destination provider must replace the filter forgotten knowledge of the destination replica. If ppFilterForgottenKnowledge returns NULL, the current filter forgotten knowledge of the destination replica must be kept.

See Also

Reference

IFilterTrackingSaveChangeContext Interface