ldap_connect 関数 (winldap.h)

ldap_connect関数は、サーバーとの接続を確立します。

構文

WINLDAPAPI ULONG LDAPAPI ldap_connect(
  [in] LDAP      *ld,
  [in] l_timeval *timeout
);

パラメーター

[in] ld

ldap_initから取得したセッション ハンドル。

[in] timeout

タイムアウトまでの接続の確立に費やす秒数を指定する LDAP_TIMEVAL構造体への ポインター。 NULL の場合、関数は既定のタイムアウト値を使用します。

戻り値

関数が成功すると、 LDAP_SUCCESS が返されます。

関数が失敗した場合は、エラー コードが返されます。 詳細については、「 戻り値」を参照してください。

解説

サーバーへの接続を確立するためにクライアント呼び出し ldap_connect 必要はありませんが、これを行うことをプログラミングすることをお勧めします。 接続が存在しない場合は、他の関数 ( ldap_bind_sなど) が内部的に呼び出しを実行します。 ただし、アプリケーションのこの部分のトラブルシューティングを行う必要がある場合は、 ldap_bind_sなどの他の関数の呼び出しを行う前に接続を確立すると、接続が失敗した場合に発生する可能性のある問題も分離されます。 または、接続ブロックに追加のオプションを指定することもできます。 たとえば、クライアントは ldap_init を呼び出してセッションを初期化し、null 以外のタイムアウト パラメーター値を指定してldap_connectを呼び出して、指定されたタイムアウトでサーバーに接続できます。

ldap_connectの呼び出しが成功した場合、クライアントは匿名ユーザーとして LDAP サーバーに接続されます。 セッション ハンドルは、不要になったときに ldap_unbind の呼び出しで解放する必要があります。

ldap_connect呼び出しが失敗した場合は、エラーの回復が不要になったときに、ldap_unbindの呼び出しでセッション ハンドルを解放する必要があります。

要件

関連項目

LDAP セッションの確立

関数

LDAP_TIMEVAL

戻り値

ldap_init

ldap_unbind