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コントロール作成処理