DsBindA 関数 (ntdsapi.h)

DsBind 関数は、ドメイン コントローラーにバインドします。DsBind は、既定のプロセス資格情報を使用してドメイン コントローラーにバインドします。 代替資格情報を指定するには、 DsBindWithCred 関数を使用します。

構文

NTDSAPI DWORD DsBindA(
  [in, optional] LPCSTR DomainControllerName,
  [in, optional] LPCSTR DnsDomainName,
  [out]          HANDLE *phDS
);

パラメーター

[in, optional] DomainControllerName

バインドするドメイン コントローラーの名前を含む null で終わる文字列へのポインター。 この名前には、ドメイン コントローラーの名前、またはドメイン コントローラーの完全修飾 DNS 名を指定できます。 どちらの名前の種類でも、必要に応じて、前に 2 つの円記号を付けることができます。 次の例はすべて、正しく書式設定されたドメイン コントローラー名を表しています。

• "FAB-DC-01"
• "\\FAB-DC-01"
• "FAB-DC-01.fabrikam.com"
• "\\FAB-DC-01.fabrikam.com"

このパラメーターは、NULL でもかまいません。 詳細については、「解説」を参照してください。

[in, optional] DnsDomainName

バインドするドメインの完全修飾 DNS 名を含む null で終わる文字列へのポインター。 このパラメーターは、NULL でもかまいません。 詳細については、「解説」を参照してください。

[out] phDS

バインド ハンドルを受け取る HANDLE 値のアドレス。 このハンドルを閉じるには、 DsUnBind 関数に渡します。

戻り値

成功した場合 はERROR_SUCCESS 、それ以外の場合は Windows または RPC エラー コードを返します。 最も一般的なエラー コードを次に示します。

注釈

DsBind 関数の動作は、DomainControllerName パラメーターと DnsDomainName パラメーターの内容によって決まります。 次の一覧では、これらのパラメーターの内容に基づいて、この関数の動作について説明します。

DomainControllerName	DnsDomainName	説明
NULL	NULL	DsBind は、ローカル コンピューターのフォレスト内のグローバル カタログ サーバーへのバインドを試みます。
(value)	NULL	DsBind は、 DomainControllerName パラメーターで指定されたドメイン コントローラーへのバインドを試みます。
NULL	(value)	DsBind は、 DnsDomainName パラメーターで指定されたドメイン内の任意のドメイン コントローラーへのバインドを試みます。
(value )	(value)	DomainControllerName パラメーターが優先されます。 DsBind は、 DomainControllerName パラメーターで指定されたドメイン コントローラーへのバインドを試みます。

 

注意

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

要件

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

こちらもご覧ください

DOMAIN_CONTROLLER_INFO

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

DsBindWithCred

DsGetDcName

DsUnBind