DsReplicaSyncA 関数 (ntdsapi.h)
DsReplicaSync 関数は、宛先の名前付けコンテキスト (NC) をソースの 1 つと同期します。
構文
NTDSAPI DWORD DsReplicaSyncA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] const UUID *pUuidDsaSrc,
[in] ULONG Options
);
パラメーター
[in] hDS
DSBind 関数または DSBindWithCred 関数から取得したディレクトリ サービス ハンドルが含まれます。
[in] NameContext
宛先 NC の識別名を指定する、null で終わる定数文字列へのポインター。
[in] pUuidDsaSrc
宛先 NC にレプリケートされるソースの UUID へのポインター。
[in] Options
要求の処理に使用される追加データを渡します。 このパラメーターは、次の値と組み合わせて使用できます。
DS_REPSYNC_ADD_REFERENCE
ソース ディレクトリ システム エージェント (DSA) に、ソースレプリケート先リストにローカル DSA が存在することを確認します。 そうでない場合は、ローカル DSA が追加されます。 これにより、ソースから変更通知が確実に送信されます。
DS_REPSYNC_ALL_SOURCES
この値はサポートされていません。
Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003: すべてのソースから同期します。
DS_REPSYNC_ASYNCHRONOUS_OPERATION
この操作を非同期的に実行します。
Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003: DS_REPSYNC_ALL_SOURCESを使用する場合は必須です。
DS_REPSYNC_FORCE
リンクが現在無効になっている場合でも同期します。
DS_REPSYNC_FULL
最初の更新シーケンス番号 (USN) から開始して同期します。
DS_REPSYNC_INTERSITE_MESSAGING
ISM を使用して同期します。
DS_REPSYNC_NO_DISCARD
同様の同期が保留中の場合でも、この同期要求を破棄しません。
DS_REPSYNC_PERIODIC
この操作が、管理者によってスケジュールされた定期的な同期要求であることを示します。
DS_REPSYNC_URGENT
この操作が、緊急としてマークされた更新プログラムの通知であることを示します。
DS_REPSYNC_WRITEABLE
レプリカは書き込み可能です。 それ以外の場合は、読み取り専用です。
戻り値
関数がその操作を正常に実行した場合、戻り値は ERROR_SUCCESS。
関数が失敗した場合、戻り値は標準的な Win32 API エラーの 1 つです。
注釈
DsReplicaSync が実行されるサーバーは、宛先と呼ばれます。 変換先の名前付けコンテキストは、ソース システム NTDS Settings オブジェクトの UUID によって識別されるソース システムに関して最新の状態に更新されます。 ソース・システムがレプリケーション・データを受け取るシステムの 1 つになるように、宛先システムが既に構成されている必要があります。
注意
ntdsapi.h ヘッダーは、DSReplicaSync をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | ntdsapi.h |
| Library | Ntdsapi.lib |
| [DLL] | Ntdsapi.dll |