DsReplicaAddA 関数 (ntdsapi.h)

[アーティクル]
08/25/2023

DsReplicaAdd 関数は、レプリケーションソース参照を宛先の名前付けコンテキストに追加します。

構文

NTDSAPI DWORD DsReplicaAddA(
  [in] HANDLE          hDS,
  [in] LPCSTR          NameContext,
  [in] LPCSTR          SourceDsaDn,
  [in] LPCSTR          TransportDn,
  [in] LPCSTR          SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           Options
);

パラメーター

[in] hDS

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

[in] NameContext

レプリカを追加する宛先名前付けコンテキスト (NC) の識別名 (DN) を指定する null で終わる文字列。宛先 NC レコードは、オブジェクトとしてローカルに存在する必要があります。インスタンス化されているか、インスタンス化されていないか、参照ファントム (GUID を持つファントムなど)。

[in] SourceDsaDn

ソースディレクトリシステムエージェントの NTDS-DSA オブジェクトの DN を指定する null で終わる文字列。 Options にDS_REPADD_ASYNCHRONOUS_REPLICAが含まれている場合は、このパラメーターが必要です。それ以外の場合は無視されます。

[in] TransportDn

ソースサーバーとの通信に使用されるトランスポートを表す interSiteTransport オブジェクトの DN を指定する null で終わる文字列。 Options にDS_REPADD_INTERSITE_MESSAGINGが含まれている場合は、このパラメーターが必要です。それ以外の場合は無視されます。

[in] SourceDsaAddress

ソース DSA のトランスポート固有のアドレスを指定する null で終わる文字列。このソースサーバーは、UUID ではなく文字列名で識別されます。 SourceDsaAddress に適した文字列名は、通常、GUID に基づく DNS 名です。この名前の GUID 部分は、ソースサーバーの NTDS-DSA オブジェクトの GUID です。

[in] pSchedule

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

[in] Options

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

DS_REPADD_ASYNCHRONOUS_OPERATION

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

DS_REPADD_ASYNCHRONOUS_REPLICA

NC をレプリケートしません。代わりに、後でレプリケートできるように、十分な状態データを保存します。

DS_REPADD_DISABLE_NOTIFICATION

このソースからの NC の通知ベースの同期を無効にします。これは一時的な状態である必要があります。 同期を完全に無効にするには、DS_REPADD_NEVER_NOTIFYを使用します。

DS_REPADD_DISABLE_PERIODIC

このソースからの NC の定期的な同期を無効にします。

DS_REPADD_INITIAL

DSA の起動時に、このソースから NC を同期します。

DS_REPADD_INTERSITE_MESSAGING

ネイティブディレクトリサービス RPC を使用するのではなく、サイト間メッセージングサービス (IMS) トランスポート (SMTP など) を使用してソース DSA から同期します。

DS_REPADD_NEVER_NOTIFY

このソースからの変更通知を無効にします。このフラグが設定されている場合、ソースは変更が発生したときに宛先に通知しません。これは、WAN リンク経由で発生する可能性があるすべてのサイト間レプリケーションに推奨されます。

これは永続的な状態であると予想されます。 DS_REPADD_DISABLE_NOTIFICATION を使用して通知を一時的に無効にします。

DS_REPADD_PERIODIC

pSchedule で定義されているように、このソースから NC を定期的に同期します。

DS_REPADD_USE_COMPRESSION

レプリケート時に圧縮を使用します。これにより、送信元サーバーと移行先サーバーの両方で CPU オーバーヘッドを犠牲にしてネットワーク帯域幅を節約できます。

DS_REPADD_WRITEABLE

書き込み可能なレプリカを作成します。それ以外の場合、レプリカは読み取り専用です。

戻り値

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

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

注釈

注意

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

要件

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