IAsynchronousNotifyingChangeApplierTarget::SaveKnowledge
Saves the knowledge for the current scope.
Note
This interface is now obsolete.
Syntax
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.