DsReplicaModifyA 関数 (ntdsapi.h)
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 |