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 エラー コードを返します。 最も一般的なエラー コードを次に示します。
備考
| DomainControllerName | DnsDomainName | 形容 |
|---|---|---|
| NULL | NULL |
dsBind |
| (値) | NULL |
dsBind |
| NULL | (値) |
|
| (value) | (値) |
DomainControllerName パラメーターが優先されます。 dsBind |
手記
ntdsapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DsBind を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| サポートされる最小サーバー | Windows Server 2008 |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | ntdsapi.h |
| ライブラリ | Ntdsapi.lib |
| DLL | Ntdsapi.dll |
関連項目
DsBindWithCred の
DsUnBind の