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