ISyncKnowledge2::ProjectOntoKnowledgeWithPrerequisite method (winsync.h)

Article
10/13/2021

Returns knowledge about the knowledge fragments that are specified by the template knowledge, when the template knowledge contains the prerequisite knowledge for the specified fragments.

Syntax

HRESULT ProjectOntoKnowledgeWithPrerequisite(
  [in]  ISyncKnowledge *pPrerequisiteKnowledge,
  [in]  ISyncKnowledge *pTemplateKnowledge,
  [out] ISyncKnowledge **ppProjectedKnowledge
);

Parameters

[in] pPrerequisiteKnowledge

Specifies the knowledge that pTemplateKnowledge must contain for knowledge to be added to ppProjectedKnowledge.

[in] pTemplateKnowledge

Specifies the set of knowledge fragments to be added to ppProjectedKnowledge.

[out] ppProjectedKnowledge

A knowledge object that contains the knowledge fragments that are specified by pTemplateKnowledge when pTemplateKnowledge contains the knowledge that is contained in pPrerequisiteKnowledge for the specified fragments.

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_ID_FORMAT_MISMATCH	The ID format schema that is contained in pPrerequisiteKnowledge or pTemplateKnowledge differs from the ID format schema of this object.

Remarks

To calculate the knowledge that is returned in ppProjectedKnowledge, this method enumerates the knowledge fragments that are contained in pTemplateKnowledge. For each knowledge fragment in pTemplateKnowledge, this method checks whether the knowledge known by pPrerequisiteKnowledge about the fragment is contained in pTemplateKnowledge. If the prerequisite knowledge that is known about a fragment is contained by pTemplateKnowledge, the knowledge that is known about that fragment by this object is added to ppProjectedKnowledge. If the prerequisite knowledge that is known about a fragment is not contained by pTemplateKnowledge, then ppProjectedKnowledge contains no knowledge about that fragment.

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