DsReplicaUpdateRefsA 関数 (ntdsapi.h)

[アーティクル]
11/20/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 が返されます。

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

備考

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

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
サポートされる最小サーバー	Windows Server 2008
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	ntdsapi.h
ライブラリ	Ntdsapi.lib
DLL	Ntdsapi.dll

次の方法で共有