SyncKnowledge::GetKnowledgeForColumns Method

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

Namespace:  Microsoft.Synchronization
Assembly:  Microsoft.Synchronization (in Microsoft.Synchronization.dll)

public:
SyncKnowledge^ GetKnowledgeForColumns(
	array<SyncId^>^ columnIds
)

Parameters

columnIds
Type: array<Microsoft.Synchronization::SyncId>
The set of change unit IDs to look up.

Return Value

Type: Microsoft.Synchronization::SyncKnowledge
Returns a knowledge object that contains only the change units that are specified by columnIds for all items contained in this object.

ExceptionCondition
ArgumentNullException

A required parameter is a nullptr.

InvalidKnowledgeVersionException

The CompatibilityLevel property is less than WindowsSync.

SyncIdFormatMismatchException

The IDs in columnIds are not in the ID format specified for this knowledge object.

InvalidOperationException

This SyncKnowledge object is not initialized.

GetKnowledgeForColumns differs from GetKnowledgeForChangeUnit. GetKnowledgeForColumns 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. GetKnowledgeForChangeUnit returns a knowledge object that contains information about a single change unit that is contained in a single item.

Show: