ldap_simple_bind関数 (winldap.h)

[アーティクル]
08/27/2023

ldap_simple_bind関数は、プレーンテキストパスワードを使用してサーバーに対してクライアントを認証します。

注意この関数は、暗号化せずに名前とパスワードを送信するため、ネットワーク上で傍受したユーザーがパスワードを読み取る可能性があります。 TLS (SSL) で暗号化されたセッションが確立されていない限り、この関数を使用しないでください。暗号化されたセッションを設定する方法の詳細については、「セッションの初期化」を参照してください。

構文

WINLDAPAPI ULONG LDAPAPI ldap_simple_bind(
  [in] LDAP       *ld,
  [in] const PSTR dn,
  [in] const PSTR passwd
);

パラメーター

[in] ld

セッションハンドル。

[in] dn

バインドするユーザーの名前。バインド操作では、 dn パラメーターと passwd パラメーターを使用してユーザーを認証します。

[in] passwd

dn パラメーターで指定されたユーザーのパスワード。

戻り値

関数が成功すると、開始された操作のメッセージ ID が返されます。

関数が失敗した場合、-1 が返され、LDAP データ構造のセッションエラーパラメーターが設定されます。

注釈

ldap_simple_bind関数は、クライアントを LDAP サーバーに対して認証するための単純な非同期バインド操作を開始します。後続のバインド呼び出しを使用して、同じ接続を使用して再認証できます。

特定のユーザーとして認証するには、エントリの名前 (ユーザー) と、そのエントリのパスワードの両方を指定します。匿名ユーザーを認証するには、アクセス許可が必要ない場合は、dn パラメーターと passwd パラメーターの両方に NULL を渡します。

非同期関数として、 ldap_simple_bind は操作のメッセージ ID を返します。操作の結果を取得するには、メッセージ ID を使用して ldap_result を呼び出します。非同期バインド操作を完了する前に取り消すには、 ldap_abandonを呼び出します。 LDAP 2 サーバーに接続している場合は、バインド呼び出しが正常に完了するまで、接続に対して他の操作を試みないでください。

結果を直接返すには、同期ルーチン ldap_simple_bind_sを使用します。

マルチスレッド: バインド呼び出しは、接続全体に適用されるため、安全ではありません。スレッドが接続を共有し、他の操作とスレッドバインドを試みる場合は注意が必要です。

メモ Microsoft LDAP クライアントは、バインド/応答ラウンドトリップごとに 120 秒 (2 分) の既定のタイムアウト値を使用します。このタイムアウト値は、 LDAP_OPT_TIMELIMIT セッションオプションを使用して変更できます。他の操作では、 ldap_set_optionを使用して指定しない限り、タイムアウトは発生しません。

セッションハンドルに対するすべての操作が完了したら、 LDAP セッションハンドルを ldap_unbind 関数に渡してセッションを終了します。また、 ldap_simple_bind 呼び出しが失敗した場合は、エラーの回復が不要になったときに 、ldap_unbind の呼び出しでセッションハンドルを解放する必要があります。

ldap_simple_bind関数は、ローカルドメインにバインドするように設計されています。この関数は、フォレスト間認証には使用できません。

要件

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