IFilterTrackingNotifyingChangeApplierTarget::SaveKnowledgeWithFilterForgottenKnowledges
When overridden in a derived class, saves knowledge, forgotten knowledge, and a list of filter forgotten knowledge objects.
HRESULT SaveKnowledgeWithFilterForgottenKnowledges(
ISyncKnowledge * pSyncKnowledge,
ISyncKnowledge * pForgottenKnowledge,
DWORD dwFilterCount,
ISyncKnowledge ** ppFilterForgottenKnowledges);
Parameters
- pSyncKnowledge
[in] The updated knowledge to be saved.
- pForgottenKnowledge
[in] The forgotten knowledge to be saved. If this parameter is NULL, existing forgotten knowledge remains unchanged and should not be replaced.
- dwFilterCount
[in] The number of filter forgotten knowledge objects contained in ppFilterForgottenKnowledges. The number of filter forgotten knowledge objects is the same as the number of filters contained in the filter key map returned by the IFilterTrackingNotifyingChangeApplierTarget::GetFilterKeyMap method.
- ppFilterForgottenKnowledges
[in] A list of filter forgotten knowledge objects to be saved. This list is ordered by the filter keys in the filter key map.
Return Value
S_OK.
Provider-determined error codes.
Remarks
pSyncKnowledge must replace the existing knowledge for the scope. If pForgottenKnowledge is not NULL, pForgottenKnowledge must also replace the forgotten knowledge for the scope; otherwise, the existing forgotten knowledge must be kept. The filter forgotten knowledge objects that are contained in ppFilterForgottenKnowledges must also replace the corresponding filter forgotten knowledge objects of the replica. Sync Framework calls this method one time per change batch after all changes in the change batch have been processed.