IAsynchronousNotifyingChangeApplierTarget::SaveKnowledge

Saves the knowledge for the current scope.

HRESULT SaveKnowledge(
  ISyncKnowledge * pSyncKnowledge,
  IForgottenKnowledge * pForgottenKnowledge);

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.

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. Sync Framework calls this method one time per change batch after all changes in the change batch have been processed.

When SaveKnowledge is called, the provider must take one of the following actions:

• Return a success code from the method and later call IAsynchronousNotifyingChangeApplierTargetCallback::SaveKnowledgeComplete to report that asynchronous processing finished successfully.

• Return a success code from the method and later call IAsynchronousNotifyingChangeApplierTargetCallback::OnError to report that an error occurred during asynchronous processing.

• Return an error code from the method. In this case, IAsynchronousNotifyingChangeApplierTargetCallback methods should not be called.

See Also

Reference

IAsynchronousNotifyingChangeApplierTarget Interface
IAsynchronousNotifyingChangeApplierTargetCallback Interface