SyncUpdateCallback デリゲート

.NET Framework クラス ライブラリ リファレンス

SyncUpdateCallback デリゲート

メモ : このデリゲートは、.NET Framework version 2.0 で新しく追加されたものです。

レプリカの同期中にイベント通知を受信します。

名前空間: System.DirectoryServices.ActiveDirectory
アセンブリ: System.DirectoryServices (system.directoryservices.dll 内)
構文

Visual Basic (宣言)

Public Delegate Function
 SyncUpdateCallback ( _
    eventType As SyncFromAllServersEvent, _
    targetServer As String, _
    sourceServer As String, _
    exception As SyncFromAllServersOperationException _
) As Boolean

Visual Basic (使用法)

Dim instance As New SyncUpdateCallback(AddressOf
 HandlerMethod)

C#

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

C++

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

J#

/** @delegate */
public delegate boolean SyncUpdateCallback (
    SyncFromAllServersEvent eventType, 
    String targetServer, 
    String sourceServer, 
    SyncFromAllServersOperationException exception
)

JScript

JScript では、デリゲートは使用できますが、新規に宣言することはできません。

パラメータ

eventType

イベントの種類を指定する SyncFromAllServersEvent メンバの 1 つ。

targetServer

レプリケーション先のサーバーの DNS 名を格納します。これが通知で使用されない場合、このパラメータは null 参照 (Visual Basic では Nothing) になります。

sourceServer

レプリケーション元のサーバーの DNS 名を格納します。これが通知で使用されない場合、このパラメータは null 参照 (Visual Basic では Nothing) になります。

exception

発生したいずれかのエラーに関する追加情報を格納している SyncFromAllServersOperationException オブジェクト。エラーが発生しなかった場合、このパラメータは null 参照 (Visual Basic では Nothing) になります。

戻り値
ADAMInstance、DirectoryServer、または DomainController の各オブジェクトで呼び出される SyncReplicaFromAllServers メソッドを再開する必要がある場合は true。SyncReplicaFromAllServers メソッドを終了する必要がある場合は false。

解説

SyncReplicaFromAllServers

操作の完了には長時間を要し、サーバー側で失敗する可能性もあります。SyncUpdateCallback コールバック機能により、アプリケーションは、SyncReplicaFromAllServers メソッドの実行を継続する必要があるかどうかを示すことができます。たとえば、アプリケーションは、エラーが発生すると false を返して、System.DirectoryServices.ActiveDirectory.DomainController.SyncReplicaFromAllServers(System.String,System.DirectoryServices.ActiveDirectory.SyncAllOptions) の実行を終了できます。

この機能は、特定のレプリケーション先サーバーおよびレプリケーション元サーバーの組み合わせの同期が完了したことをアプリケーションが検出したときに、System.DirectoryServices.ActiveDirectory.DomainController.SyncReplicaFromAllServers(System.String,System.DirectoryServices.ActiveDirectory.SyncAllOptions) の実行を終了する場合にも使用されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.DirectoryServices.ActiveDirectory 名前空間
SyncFromAllServersEvent 列挙体
SyncFromAllServersOperationException クラス
DomainController.SyncFromAllServersCallback プロパティ
AdamInstance.SyncFromAllServersCallback プロパティ
System.DirectoryServices.ActiveDirectory.ADAMInstance.SyncReplicaFromAllServers(System.String,System.DirectoryServices.ActiveDirectory.SyncFromAllServersOptions)
DomainController.SyncReplicaFromAllServers