DsReplicaSyncA 関数 (ntdsapi.h)

[アーティクル]
11/20/2024

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 設定オブジェクトの UUID によって識別されるソースシステムに関して -date up-toされます。レプリケーション元システムがレプリケーションデータを受信するシステムの 1 つになるように、移行先システムが既に構成されている必要があります。

注意手動同期を強制すると、ディレクトリサービスがレプリケーション操作の優先順位を適切に設定できなくなる可能性があります。たとえば、新しいユーザーを同期すると、最近ロックアウトされたユーザーへのアクセスを提供したり、新しい信頼パスワードを追加したりするために、緊急の同期が実行される可能性があります。この API を頻繁に呼び出すと、ネットワークに要求が殺到し、他のレプリケーション操作に干渉する可能性があります。このため、この関数は、定期的に使用するアプリケーションに組み込むのではなく、単一使用のシナリオでのみ使用することを強くお勧めします。

手記

ntdsapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DsReplicaSync を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
サポートされる最小サーバー	Windows Server 2008
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	ntdsapi.h
ライブラリ	Ntdsapi.lib
DLL	Ntdsapi.dll

次の方法で共有