DsReplicaUpdateRefsA 関数 (ntdsapi.h)

[アーティクル]
02/29/2024

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

構文

NTDSAPI DWORD DsReplicaUpdateRefsA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] LPCSTR     DsaDest,
  [in] const UUID *pUuidDsaDest,
  [in] ULONG      Options
);

パラメーター

[in] hDS

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

[in] NameContext

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

[in] DsaDest

転送先ディレクトリシステムエージェントのトランスポート固有のアドレスを指定する、null で終わる定数文字列へのポインター。

[in] pUuidDsaDest

宛先ディレクトリシステムエージェントを含む UUID 値へのポインター。

[in] Options

要求の処理に使用される追加のデータを提供するフラグのセットが含まれています。これは、0 または次の値の 1 つ以上の組み合わせにすることができます。

DS_REPUPD_ADD_REFERENCE

移行先への参照がソースサーバーに追加されます。

DS_REPUPD_ASYNCHRONOUS_OPERATION

操作は非同期的に実行されます。

DS_REPUPD_DELETE_REFERENCE

移行先への参照がソースサーバーから削除されます。

DS_REPUPD_WRITEABLE

追加または削除されたレプリカへの参照は書き込み可能です。それ以外の場合は、読み取り専用です。

戻り値

関数が成功すると、 ERROR_SUCCESS が返されます。

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

注釈

DS_REPUPD_ADD_REFERENCEとDS_REPUPD_DELETE_REFERENCEの両方が Options パラメーターに設定されている場合は、サーバーにまだ存在しない場合は、変換先への参照が追加されます。宛先への参照が既に存在する場合は、参照が更新されます。

注意

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

要件

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