Share via

FeedSyncServices.GetChangeBatch Method

  • Article

Gets a change batch from the loaded FeedSync feed. The change batch contains item metadata for items that are not contained in the specified knowledge from the destination provider.

Namespace: Microsoft.Synchronization.FeedSync
Assembly: Microsoft.Synchronization (in microsoft.synchronization.dll)

Syntax

'Declaration
Public Function GetChangeBatch ( _
    batchSize As UInteger, _
    destinationKnowledge As SyncKnowledge, _
    filterInfo As FilterInfo, _
    itemMetadataFilterDelegate As ItemMetadataFilter, _
    <OutAttribute> ByRef changeDataRetriever As Object _
) As ChangeBatch
'Usage
Dim instance As FeedSyncServices
Dim batchSize As UInteger
Dim destinationKnowledge As SyncKnowledge
Dim filterInfo As FilterInfo
Dim itemMetadataFilterDelegate As ItemMetadataFilter
Dim changeDataRetriever As Object
Dim returnValue As ChangeBatch

returnValue = instance.GetChangeBatch(batchSize, destinationKnowledge, filterInfo, itemMetadataFilterDelegate, changeDataRetriever)

public ChangeBatch GetChangeBatch (
    uint batchSize,
    SyncKnowledge destinationKnowledge,
    FilterInfo filterInfo,
    ItemMetadataFilter itemMetadataFilterDelegate,
    out Object changeDataRetriever
)

public:
ChangeBatch^ GetChangeBatch (
    unsigned int batchSize, 
    SyncKnowledge^ destinationKnowledge, 
    FilterInfo^ filterInfo, 
    ItemMetadataFilter^ itemMetadataFilterDelegate, 
    [OutAttribute] Object^% changeDataRetriever
)

public ChangeBatch GetChangeBatch (
    UInt32 batchSize, 
    SyncKnowledge destinationKnowledge, 
    FilterInfo filterInfo, 
    ItemMetadataFilter itemMetadataFilterDelegate, 
    /** @attribute OutAttribute() */ /** @ref */ Object changeDataRetriever
)

JScript does not support passing value-type arguments by reference.

Parameters

  • batchSize
    The size of the batch to be created.
  • destinationKnowledge
    The knowledge from the destination provider.
  • filterInfo
    Filter information that is used to control which items are included in the change batch. Can be a null reference (Nothing in Visual Basic).
  • itemMetadataFilterDelegate
    A delegate that is used to dynamically filter items added to the change batch. Can be a null reference (Nothing in Visual Basic).
  • changeDataRetriever
    Returns an object that can be used by the destination provider to retrieve item data from the source provider. The object can be an IChangeDataRetriever object or a provider-specific object.

Return Value

A change batch that contains item metadata for items that are not contained in the specified knowledge from the destination provider.

Remarks

This method helps a synchronization provider implement the GetChangeBatch method. If filterInfo is not a null reference (Nothing in Visual Basic), the information is used to filter the items that are added to the change batch. If itemMetadataFilterDelegate is not a null reference (Nothing in Visual Basic), the delegate is called one time before each item is added to the change batch.

See Also

Reference

FeedSyncServices Class
FeedSyncServices Members
Microsoft.Synchronization.FeedSync Namespace