Interstage Application Server Smart Repository運用ガイド

6.2.2.1 ldap_init

　この関数は、SSLを使用しない環境で、LDAPのセションをオープンします。

【指定形式】

LDAP  *ldap_init(
        char  *hostname,
        int  portno
        );

【パラメタの説明】

• hostname

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

• portno

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

【復帰値】

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

• 正常完了の場合：セションハンドル
• 異常完了の場合：NULL

  　正常完了の場合、セションハンドルには獲得したLDAP構造体へのポインタが通知されます。
  　異常完了の場合、以下の原因が考えられます。

  • LDAP構造体用のメモリが獲得できないなど、システムの資源が不足した。
  • トレースを取得している場合には、トレースファイルのバックアップに失敗した。
    

【注意事項】

• セションハンドル

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

• 簡易認証について

  　DNを使用した簡易認証を行う場合、認証はDNとパスワードを使用して行われます。この場合、DNによる簡易認証とSSLによる安全にされていない通信が行われます。簡易認証については、“リポジトリサーバとのユーザ認証”を参照してください。

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

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