DsRemoveDsServerA 関数 (ntdsapi.h)
DsRemoveDsServer 関数は、ディレクトリ サービス エージェント (DSA) のすべてのトレースをディレクトリ サービスのグローバル領域から削除します。
構文
NTDSAPI DWORD DsRemoveDsServerA(
[in] HANDLE hDs,
[in] LPSTR ServerDN,
[in, optional] LPSTR DomainDN,
[out, optional] BOOL *fLastDcInDomain,
[in] BOOL fCommit
);
パラメーター
[in] hDs
DSBind または DSBindWithCred 関数から取得したディレクトリ サービス ハンドルが含まれます。
[in] ServerDN
削除するドメイン コントローラーの完全修飾識別名を指定する null で終わる文字列へのポインター。
[in, optional] DomainDN
ServerDN によってホストされるドメインを指定する null で終わる文字列へのポインター。 このパラメーターが NULL の場合、 ServerDN が DomainDN の最後のドメイン コントローラーであることを確認するための検証は実行されません。
[out, optional] fLastDcInDomain
ServerDN が DomainDN の最後の DC である場合は TRUE、それ以外の場合は FALSE を受け取るブール値へのポインター。 DomainDN が NULL の場合、このパラメーターは FALSE を受け取ります。
[in] fCommit
ドメイン コントローラーを実際に削除するかどうかを指定するブール値が含まれます。 このパラメーターが 0 以外の場合、 ServerDN は削除されます。 このパラメーターが 0 の場合、 ServerDN の存在がチェックされ、 fLastDcInDomain が書き込まれますが、ドメイン コントローラーは削除されません。
戻り値
成功した場合 はERROR_SUCCESS を返し、失敗した場合は Win32 または RPC エラー コードを返します。 考えられるエラー コードは次のとおりです。
注釈
注意
ntdsapi.h ヘッダーは、DSRemoveDsServer をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | ntdsapi.h |
| Library | Ntdsapi.lib |
| [DLL] | Ntdsapi.dll |