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