DsBindWithCredA 関数 (ntdsapi.h)
DsBindWithCred 関数は、指定した資格情報を使用してドメイン コントローラーにバインドします。
構文
NTDSAPI DWORD DsBindWithCredA(
[in, optional] LPCSTR DomainControllerName,
[in, optional] LPCSTR DnsDomainName,
[in, optional] RPC_AUTH_IDENTITY_HANDLE AuthIdentity,
[out] HANDLE *phDS
);
パラメーター
[in, optional] DomainControllerName
バインドするドメインの完全修飾 DNS 名を含む null で終わる文字列へのポインター。 このパラメーターの詳細については、DsBind トピックの DomainControllerName の説明を参照してください。
[in, optional] DnsDomainName
バインドするドメインの完全修飾 DNS 名を含む null で終わる文字列へのポインター。 このパラメーターの詳細については、DsBind トピックの DnsDomainName の説明を参照してください。
Kerberos 認証をセキュリティで保護するには、このパラメーターが必要です。
[in, optional] AuthIdentity
バインドに使用する資格情報を表す RPC_AUTH_IDENTITY_HANDLE 値を格納します。 次に、
DsMakePasswordCredentials 関数を使用して、この値を取得します。 このパラメーターが NULL の場合は、呼び出し元スレッドの資格情報が使用されます。
DsFreePasswordCredentials 関数を使用してこのハンドルを解放する前に、DsUnBind を呼び出す必要があります。
[out] phDS
バインド ハンドルを受け取る HANDLE 値のアドレス。 このハンドルを閉じるには、 DsUnBind 関数に渡します。
戻り値
成功した場合 はERROR_SUCCESS 、それ以外の場合は Windows または RPC エラー コードを返します。 最も一般的なエラー コードを次に示します。
注釈
注意
ntdsapi.h ヘッダーは、DsBindWithCred をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | ntdsapi.h |
| Library | Ntdsapi.lib |
| [DLL] | Ntdsapi.dll |