DsReplicaModifyA 関数 (ntdsapi.h)

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

DsReplicaModify 関数は、宛先の名前付けコンテキストの既存のレプリケーションソース参照を変更します。

構文

NTDSAPI DWORD DsReplicaModifyA(
  [in] HANDLE          hDS,
  [in] LPCSTR          NameContext,
  [in] const UUID      *pUuidSourceDsa,
  [in] LPCSTR          TransportDn,
  [in] LPCSTR          SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           ReplicaFlags,
  [in] DWORD           ModifyFields,
  [in] DWORD           Options
);

パラメーター

[in] hDS

DSBind または DSBindWithCred 関数から取得したディレクトリサービスハンドル含まれます。

[in] NameContext

宛先の名前付けコンテキスト (NC) の識別名 (DN) を指定する、null で終わる定数文字列へのポインター。

[in] pUuidSourceDsa

ソースディレクトリシステムエージェント (DSA) の UUID へのポインター。 ModifyFields に DS_REPMOD_UPDATE_ADDRESS が含まれていない場合、および SourceDsaAddress が NULLされていない場合、このパラメーターは null になる可能性があります。

[in] TransportDn

将来の使用のために予約されています。 NULL 以外の値を指定すると、ERROR_NOT_SUPPORTED が返されます。

[in] SourceDsaAddress

ソース DSA のトランスポート固有のアドレスを指定する、null で終わる定数 Unicode 文字列へのポインター。このパラメーターは、pUuidSourceDsa が NULL されていない場合、および ModifyFields に DS_REPMOD_UPDATE_ADDRESSが含まれていない場合は無視されます。

[in] pSchedule

レプリケーションソースのレプリケーションスケジュールデータを含む SCHEDULE 構造体へのポインター。このパラメーターは省略可能であり、使用しない場合は NULL できます。 ModifyFields に DS_REPMOD_UPDATE_SCHEDULE フラグが含まれている場合は、このパラメーターが必要です。

[in] ReplicaFlags

このパラメーターは、レプリケーションの動作を制御するために使用され、次の値を受け取ることができます。

DS_REPL_NBR_SYNC_ON_STARTUP

このソースからのこの名前付けコンテキストのレプリケーションは、移行先サーバーの起動時に試行されます。これは通常、サイト内ネイバーにのみ適用されます。

DS_REPL_NBR_DO_SCHEDULED_SYNCS

スケジュールに従ってレプリケーションを実行します。通常、この名前付けコンテキストとソースのスケジュールが "never" (空のスケジュール) でない限り、このフラグは設定されます。

DS_REPL_NBR_TWO_WAY_SYNC

設定されている場合は、受信レプリケーションが完了したときに、レプリケーション先サーバーが逆方向に同期するように移行元サーバーに指示する必要があることを示します。この機能は、2 台のサーバーのうち 1 台のみがダイヤルアップ接続を開始できるダイヤルアップシナリオで使用されます。たとえば、このオプションは、本社とブランチオフィスで使用され、ブランチオフィスはダイヤルアップ ISP 接続によってインターネット経由で本社に接続されます。

DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS

この近隣ノードは、通知ベースの同期を無効にするように設定されています。サイト内では、ドメインコントローラーは、変更が発生した場合の通知に基づいて相互に同期します。この設定により、この近隣ノードは通知によってトリガーされる同期を実行できなくなります。ネイバーは、スケジュールに基づいて、または手動で要求された同期に応答して同期を実行します。

DS_REPL_NBR_DISABLE_SCHEDULED_SYNC

この近隣ノードは、スケジュールに基づいて同期を実行しないように設定されています。このネイバーが同期を実行する唯一の方法は、変更通知に応答するか、手動で要求された同期に応答することです。

DS_REPL_NBR_COMPRESS_CHANGES

このソースから受け取った変更は圧縮されます。これは通常、ソースサーバーが別のサイトにある場合にのみ設定されます。

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS

このソースから変更通知を受け取る必要はありません。これは通常、ソースサーバーが別のサイトにある場合にのみ設定されます。

[in] ModifyFields

変更するフィールドを指定します。 ModifyFieldsでは、少なくとも 1 つのフィールド指定する必要があります。このパラメーターには、次の値の組み合わせを指定できます。

DS_REPMOD_UPDATE_ADDRESS

参照先サーバーに関連付けられているアドレスを更新します。

DS_REPMOD_UPDATE_FLAGS

レプリカに関連付けられているフラグを更新します。

DS_REPMOD_UPDATE_RESULT

使用されません。現在、結果値の更新の指定はサポートされていません。結果の値の既定値は 0 です。

DS_REPMOD_UPDATE_SCHEDULE

レプリカに関連付けられている定期的なレプリケーションスケジュールを更新します。

DS_REPMOD_UPDATE_TRANSPORT

レプリカに関連付けられているトランスポートを更新します。

[in] Options

要求の処理に使用される追加のデータを渡します。このパラメーターには、次の値の組み合わせを指定できます。

DS_REPMOD_ASYNCHRONOUS_OPERATION

この操作を非同期的に実行します。

DS_REPMOD_WRITEABLE

変更対象のレプリカを書き込むことができることを示します。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS。

関数が失敗した場合、戻り値は次のいずれかになります。

備考

手記

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

必要条件

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

次の方法で共有