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