Share via

ChangeApplicationServices.EndFullEnumerationChangeApplication Method

  • Article

Ends processing of a set of changes as part of a recovery synchronization.

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

Syntax

'Declaration
Public Sub EndFullEnumerationChangeApplication ( _
    batchLearnedKnowledge As SyncKnowledge, _
    batchLearnedForgottenKnowledge As ForgottenKnowledge, _
    <OutAttribute> ByRef destinationKnowledge As SyncKnowledge, _
    <OutAttribute> ByRef destinationForgottenKnowledge As ForgottenKnowledge _
)
'Usage
Dim instance As ChangeApplicationServices
Dim batchLearnedKnowledge As SyncKnowledge
Dim batchLearnedForgottenKnowledge As ForgottenKnowledge
Dim destinationKnowledge As SyncKnowledge
Dim destinationForgottenKnowledge As ForgottenKnowledge

instance.EndFullEnumerationChangeApplication(batchLearnedKnowledge, batchLearnedForgottenKnowledge, destinationKnowledge, destinationForgottenKnowledge)

public void EndFullEnumerationChangeApplication (
    SyncKnowledge batchLearnedKnowledge,
    ForgottenKnowledge batchLearnedForgottenKnowledge,
    out SyncKnowledge destinationKnowledge,
    out ForgottenKnowledge destinationForgottenKnowledge
)

public:
void EndFullEnumerationChangeApplication (
    SyncKnowledge^ batchLearnedKnowledge, 
    ForgottenKnowledge^ batchLearnedForgottenKnowledge, 
    [OutAttribute] SyncKnowledge^% destinationKnowledge, 
    [OutAttribute] ForgottenKnowledge^% destinationForgottenKnowledge
)

public void EndFullEnumerationChangeApplication (
    SyncKnowledge batchLearnedKnowledge, 
    ForgottenKnowledge batchLearnedForgottenKnowledge, 
    /** @attribute OutAttribute() */ /** @ref */ SyncKnowledge destinationKnowledge, 
    /** @attribute OutAttribute() */ /** @ref */ ForgottenKnowledge destinationForgottenKnowledge
)

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

Parameters

  • batchLearnedKnowledge
    The learned knowledge of the change batch.
  • batchLearnedForgottenKnowledge
    The learned forgotten knowledge of the change batch.
  • destinationKnowledge
    Returns the updated destination knowledge, based on the changes that were applied or skipped.
  • destinationForgottenKnowledge
    Returns the updated destination forgotten knowledge, based on the changes that were applied or skipped.

Exceptions

Exception type Condition

ArgumentNullException

A required parameter is a null reference (Nothing in Visual Basic).

SyncIdFormatMismatchException

The ID format schema of the specified knowledge object does not match the ID format schema specified when this object was initialized.

SyncInvalidOperationException

Change application was not started.

Remarks

The learned knowledge of the change batch, specified by batchLearnedKnowledge, and the learned forgotten knowledge of the change batch, specified by batchLearnedForgottenKnowledge, are modified by this method to exclude any changes that were reported as skipped during change application.

The updated destination knowledge returned in destinationKnowledge and the updated destination forgotten knowledge returned in destinationForgottenKnowledge must replace the current knowledge and forgotten knowledge of the destination replica.

Note

When the updated destination knowledge is calculated, any changes that the destination provider did not reported as successfully applied by calling ReportItemChangeApplied or ReportChangeUnitChangeApplied are treated as having failed.

See Also

Reference

ChangeApplicationServices Class
ChangeApplicationServices Members
Microsoft.Synchronization Namespace