DsReplicaModifyA 関数 (ntdsapi.h)

[アーティクル]
03/05/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 ヘッダーは、DSReplicaModify をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	ntdsapi.h
Library	Ntdsapi.lib
[DLL]	Ntdsapi.dll