Expand Minimize

SyncUpdateCallback Delegate

Receives event notifications during a replica synchronization.

Namespace:  System.DirectoryServices.ActiveDirectory
Assembly:  System.DirectoryServices (in System.DirectoryServices.dll)

public delegate bool SyncUpdateCallback(
	SyncFromAllServersEvent eventType,
	string targetServer,
	string sourceServer,
	SyncFromAllServersOperationException exception
)

Parameters

eventType
Type: System.DirectoryServices.ActiveDirectory.SyncFromAllServersEvent

One of the SyncFromAllServersEvent members that specifies the type of event.

targetServer
Type: System.String

Contains the DNS name of the server that is the target of the replication. This parameter will be null if it is not used by the notification.

sourceServer
Type: System.String

Contains the DNS name of the server that is the source of the replication. This parameter will be null if it is not used by the notification.

exception
Type: System.DirectoryServices.ActiveDirectory.SyncFromAllServersOperationException

A SyncFromAllServersOperationException object that contains additional information about any error that has occurred. This parameter will be null if no error has occurred.

Return Value

Type: System.Boolean
true if the SyncReplicaFromAllServers method invoked on a ADAMInstance, DirectoryServer or DomainController object should resume; false if the SyncReplicaFromAllServers method should terminate.

The SyncReplicaFromAllServers

operation takes a long time to complete and potentially could fail on a server. The SyncUpdateCallback callback function enables the application to indicate whether the SyncReplicaFromAllServers method should continue executing. For example, the application could return false to terminate SyncReplicaFromAllServers

execution if an error occurs. Another scenario in which this capability would be used is to terminate SyncReplicaFromAllServers

execution once the application detects that synchronization has completed for a certain target server or source server pair.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft