ISyncChangeBatchBase::GetLearnedKnowledge method (winsync.h)

Article
10/13/2021

Gets the knowledge that the destination replica learns when the destination provider applies all the changes in this change batch.

Syntax

HRESULT GetLearnedKnowledge(
  [out] ISyncKnowledge **ppLearnedKnowledge
);

Parameters

[out] ppLearnedKnowledge

Returns the knowledge that a replica will learn when a provider applies all the changes in this change batch to the replica. This knowledge is valid only when the current knowledge of the replica contains the prerequisite knowledge of the change batch. The prerequisite knowledge can be obtained by calling ISyncChangeBatchBase::GetPrerequisiteKnowledge.

Return value

The possible return codes include, but are not limited to, the values shown in the following table.

Return code	Description
S_OK	The method succeeded.
E_POINTER	Invalid pointer.
SYNC_E_INVALID_OPERATION	The last group added to the batch was not ended.

Remarks

GetLearnedKnowledge can be used by a provider that uses a custom change applier.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	winsync.h