DsReplicaDelA 関数 (ntdsapi.h)

[アーティクル]
11/20/2024

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

構文

NTDSAPI DWORD DsReplicaDelA(
  [in] HANDLE hDS,
  [in] LPCSTR NameContext,
  [in] LPCSTR DsaSrc,
  [in] ULONG  Options
);

パラメーター

[in] hDS

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

[in] NameContext

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

[in] DsaSrc

ソースディレクトリシステムエージェント (DSA) のトランスポート固有のアドレスを指定する、null で終わる定数 Unicode 文字列へのポインター。このソースサーバーは、UUIDではなく、文字列名によって識別されます。 DsaSrc に適した文字列名は、通常、GUIDに基づく DNS 名です。この名前の GUID 部分は、ソースサーバーの nTDSDSA オブジェクトの GUID です。

[in] Options

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

DS_REPDEL_ASYNCHRONOUS_OPERATION

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

DS_REPDEL_IGNORE_ERRORS

レプリケーション先のサーバーの一覧からこの NC を削除するようソースに指示するためにソースに接続して生成されたエラーを無視します。

DS_REPDEL_INTERSITE_MESSAGING

ネイティブディレクトリサービス RPC を使用して同期するのではなく、レプリカがメールベースであることを示します。

DS_REPDEL_LOCAL_ONLY

レプリケート先のサーバーの一覧からこの NC を削除するようにソースに指示しません。このフラグが設定されておらず、リンクが RPC に基づいている場合、ソースに接続されます。

DS_REPDEL_NO_SOURCE

NC 内のすべてのオブジェクトを削除します。このオプションは、ソースのない読み取り専用の NC に対してのみ有効です。

DS_REPDEL_REF_OK

他の読み取り専用レプリカをソースにした場合でも、読み取り専用レプリカを削除できます。

DS_REPDEL_WRITEABLE

削除されたレプリカの書き込みが可能であることを示します。

戻り値

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

関数が失敗した場合、戻り値は標準の Win32 API エラーです。パラメーターが無効な場合は ERROR_INVALID_PARAMETER。

備考

手記

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

必要条件

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

次の方法で共有