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)
Syntax
'Declaration
Public Function GetKnowledgeForColumns ( _
columnIds As SyncId() _
) As SyncKnowledge
'Usage
Dim instance As SyncKnowledge
Dim columnIds As SyncId()
Dim returnValue As SyncKnowledge
returnValue = instance.GetKnowledgeForColumns(columnIds)
public SyncKnowledge GetKnowledgeForColumns(
SyncId[] columnIds
)
public:
SyncKnowledge^ GetKnowledgeForColumns(
array<SyncId^>^ columnIds
)
member GetKnowledgeForColumns :
columnIds:SyncId[] -> SyncKnowledge
public function GetKnowledgeForColumns(
columnIds : SyncId[]
) : SyncKnowledge
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.
Exceptions
Exception | Condition |
---|---|
ArgumentNullException | A required parameter is a null reference (Nothing in Visual Basic). |
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. |
Remarks
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.