InfoDirectory SDK 使用手引書

2.2 関数インタフェース

　C言語プログラムでのLDAPのクライアントAPIの関数仕様について説明します。
　本ライブラリを使用する場合、以下の注意が必要です。

動作環境

　SDKのライブラリに対するディレクトリは、インストール時に/usr/libからシンボリック・リンクが設定されます。

 

コンパイル／リンクの際のオプション

　LDAPのクライアントAPI関数を使用する場合、コンパイルやリンクの際に以下のオプションを指定する必要があります。

• コンパイル時（必須）

  　以下を指定します。

  　　"-fPIC"

  　マルチスレッド環境で使用する場合には以下を指定します。

  　　"-fPIC -DMULTI -D_REENTRANT"

• リンク時(必須)

  　以下のライブラリを指定します。

  　　"-ldl -lnsl -lidldap2"

  　マルチスレッド環境で使用する場合には以下のライブラリを指定します。

  　　"-ldl -lnsl -lpthread -lidldap2"

   

ヘッダファイル

　各関数を呼出す際に使用する構造体やdefineシンボルは、idldap.hに定義されていますので、ソース中に以下の行を記述する必要があります。

　#include　"idldap.h"

 

文字列データの受渡し

　関数のパラメタで文字列データのアドレスを指定する場合、指定された文字列の最後には、“\0”（NULL文字）が設定する必要があります。
　また、復帰値に文字列データのアドレスを通知される場合、通知された文字列の最後に、“\0”（NULL文字）が設定されています。

 

マルチスレッド環境での使用

　LDAPのクライアントAPI関数は、スレッドセーフです。しかし、1個のセションを複数のスレッドで共有することはできません。
　複数のスレッドがInfoDirectoryサーバと通信する場合、各スレッドが各セションをオープンする必要があります。

 

---

2.2.1 API関数の一覧

2.2.2 セションのオープン／初期設定

2.2.3 セションハンドルオプションの設定／参照

2.2.4 InfoDirectoryサーバとのユーザ認証

2.2.5 セションのクローズ

2.2.6 エントリの検索

2.2.7 属性値の比較

2.2.8 エントリの変更

2.2.9 エントリ名の変更

2.2.10 エントリの追加

2.2.11 エントリの削除

2.2.12 LDAP V3プロトコル拡張

2.2.13 非同期処理の中止

2.2.14 処理結果の受取り／判定

2.2.15 エラー情報の取得

2.2.16 メッセージリスト処理

2.2.17 検索結果の解析処理

2.2.18 動的メモリの解放

2.2.19 エンコード／デコード処理

2.2.20 LDAPコントロール作成処理