DsReplicaDelA 関数 (ntdsapi.h)

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

要件

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