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

こちらもご覧ください

ドメイン コントローラーとレプリケーション管理機能

DsBind

DsBindWithCred

DsRemoveDsDomain