ISyncKnowledge2::ProjectOntoColumnSet method (winsync.h)

Article
10/13/2021

Returns the knowledge for the specified set of change units for all the items that are contained in this object.

Syntax

HRESULT ProjectOntoColumnSet(
  [in]  const BYTE      **ppColumns,
  [in]  DWORD           count,
  [out] ISyncKnowledge2 **ppiKnowledgeOut
);

Parameters

[in] ppColumns

The set of change unit IDs to look up.

[in] count

The number of change unit IDs that are contained in ppColumns.

[out] ppiKnowledgeOut

A knowledge object that contains only the change units that are specified by ppColumns for all items contained in this object.

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_INVALIDARG	count is zero.
E_POINTER	Invalid pointer.
SYNC_E_ID_FORMAT_MISMATCH	The format of the change unit IDs that is contained in ppColumns is not of the format that the format schema of the provider specified.

Remarks

ProjectOntoColumnSet differs from ISyncKnowledge::ProjectOntoChangeUnit. ProjectOntoColumnSet returns a knowledge object that contains information about the specified set of change units for all the items that are contained in the knowledge object. ProjectOntoChangeUnit returns a knowledge object that contains information about a single change unit that is contained in a single item.

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