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"
[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 |