ldap_simple_bind_s関数 (winldap.h)
ldap_simple_bind_s関数は、プレーンテキスト パスワードを使用して、サーバーに対してクライアントを同期的に認証します。
注意 この関数は、暗号化せずに名前とパスワードを送信し、ネットワーク上の承認されていないユーザーがパスワードを読み取ることができました。 TLS (SSL) で暗号化されたセッションが確立されていない限り、この機能は行わないでください。 暗号化されたセッションを設定する方法の詳細については、「 セッションの初期化」を参照してください。
構文
WINLDAPAPI ULONG LDAPAPI ldap_simple_bind_s(
[in] LDAP *ld,
[in] const PSTR dn,
[in] const PSTR passwd
);
パラメーター
[in] ld
セッション ハンドル。
[in] dn
バインドするユーザーの名前。 バインド操作では、 dn パラメーターと passwd パラメーターを使用してユーザーを認証します。
[in] passwd
dn パラメーターで指定されたユーザーのパスワード。
戻り値
関数が成功した場合、戻り値は LDAP_SUCCESS。
関数が失敗した場合はエラー コードを返します。 詳細については、「 戻り値」を参照してください。
解説
ldap_simple_bind_s関数は、LDAP サーバーに対してクライアントを認証するための単純な同期バインド操作を開始します。 後続のバインド呼び出しを使用して、同じ接続を使用して再認証できます。
バインド操作が完了すると、 ldap_simple_bind_s は呼び出し元に戻ります。 操作 を 非同期的に実行する場合は、ldap_simple_bindを使用します。 LDAP 2 サーバーに接続されている場合は、バインド呼び出しが正常に完了するまで、接続経由で他の操作を試行しないでください。
マルチスレッド: バインド呼び出しは接続全体に適用されるため、安全ではありません。 スレッドが接続を共有し、スレッドが他の操作とバインドしようとする場合は注意が必要です。
メモ Microsoft LDAP クライアントは、バインド/応答ラウンドトリップごとに 120 秒 (2 分) の既定のタイムアウト値を使用します。 このタイムアウト値は、 LDAP_OPT_TIMELIMIT セッション オプションを使用して変更できます。 ldap_set_optionを使用して指定しない限り、他の操作にはタイムアウトはありません。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | winldap.h |
| Library | Wldap32.lib |
| [DLL] | Wldap32.dll |