Interstage Application Server リファレンスマニュアル（API編）

1.20.1.1 ldap_init()

名前

　ldap_init

形式

　#include "idldap.h"
　LDAP  *ldap_init(
　        const char  *hostname,
　        int  portno );

機能説明

　この関数は、LDAPのセションをオープンします。
　これ以降に呼び出す関数は、ここで取得したセションハンドルをパラメタに指定します。セションハンドルは、そのセションをクローズするまで有効です。

　認証はDNとパスワードを使用して行われます。簡易認証については、“リポジトリサーバとのユーザ認証インタフェース”を参照してください。

パラメタ

　hostname

　リポジトリサーバのホスト名、またはIPアドレスを示す文字列のアドレスを指定します。ホスト名やIPアドレスは、空白で区切って複数指定することができます。hostnameにNULLを指定した場合、"localhost"が設定されたと見なします。複数の相手ホストが指定された場合、コネクションを確立する際に指定された順番で接続を試みて、接続に成功した最初のホストと通信を行います。

　portno

　リポジトリサーバのポート番号を指定します。デフォルトのLDAPポートを使用する場合は、ポート番号に0を指定します。デフォルトのポート番号はLDAP_PORT“389”です。

復帰値

　この関数は、復帰値として以下の値を返します。

• 正常終了の場合：セションハンドル

  　正常終了の場合、セションハンドルには獲得したセションハンドルへのポインタが通知されます。

• 異常終了の場合：NULL

  　異常終了の場合、以下の原因が考えられます。

  • セションハンドル用のメモリが獲得できないなど、システムの資源が不足した。
  • パラメタの指定に誤りがあります。

注意事項

• セションの共用について

  　オープンした1つのセションを複数のスレッドで共有し、各スレッドからLDAP要求を行うことはできません。スレッドを使用しLDAP要求を行う場合、各スレッドでldap_init()で獲得したセションを使用し、それぞれのスレッドからLDAP要求をしてください。

• 複数ホストの指定について

  　2つ以上のリポジトリに対して指定したホストの中で起動しているリポジトリに接続するような用途には使用できません。
  （1つ目のホストに接続してリポジトリが起動していなければ、2つ目のホストのリポジトリに接続を試みる。）

  　複数のホストを指定した場合は、1つ目のホストに対してCONNECTを行いソケットレベルで接続できない場合にのみ、2つ目以降のホストに対して接続を試みます。上記のようなリポジトリ起動チェックを行う場合は、リポジトリの起動をldap_simple_bind()/ldap_simple_bind_s()で確認するように、APIを使用してアプリケーション側での対応が必要です。