Interstage Application Server Smart Repository運用ガイド
目次 索引 前ページ次ページ

第5章 アプリケーションの作成(C API)> 5.1 C APIの使用方法> 5.1.2 LDAP操作の流れ

5.1.2.3 Smart Repositoryサーバへのアクセス

エントリの検索

 Smart Repositoryサーバに対してエントリの検を要求すると、検索でヒットしたエントリの情報が通知されます。エントリを検索する場合、以下の関数を使用します。

 エントリを検索する場合、以下のパラメタを指定することができます。

 これらのパラメタの中で、検索フィルタと属性名リストは省略することができます。検索フィルタと属性名リストを省略した場合、通知される情報は以下のようになります。

 また、以下に示すセションハンドルオプションのパラメタの設定により、検索処理の環境を指定することができます。

属性値の比較

 属性値の比を行うことにより、属性値の読込みを行わずに値を判定することができます。属性値を比較する場合、以下の関数を使用します。

 属性値を比較する場合、クライアントは、以下のパラメタを指定します。

 Smart Repositoryサーバは、指定されたエントリの属性値が、クライアントが指定した値と一致しているかどうかを通知します。

 

エントリの変更

 エントリの変では、指定された属性を追加/削除/置換することができます。この時、指定されなかった属性は変更しません。

 エントリを変更する場合には、以下の関数を使用します。

 エントリを変更する場合、クライアントは、パラメタとして以下のものを指定します。

 Smart Repositoryサーバは、指定された変更操作の種類に従って以下の処理を行います。

  1. 属性値の追加
     エントリに、指定された属性と属性値を追加します。
     属性値の追加処理の図を以下に示します。

     既存の属性を指定した場合、指定された属性に属性値を追加します。

  2. 属性値の削除
     指定された属性から、クライアントが指定した属性値を削除します。このとき、エントリの属性値の数が1個の場合には、属性を削除します。
     属性値の削除処理の図を以下に示します。

     また、属性名のみを指定し、属性値を省略した場合には、指定された属性を削除します。

  3. 属性値の置換
     指定された属性の値を、クライアントが指定した値と置き換えます。
     属性値の置換処理の図を以下に示します。

名前の変

 DN、またはRDNを変更する場合は、以下の関数を使用します。

 各関数の仕様については、“エントリ名の変更”を参照してください。エントリのDN、またはRDNを変更する場合、クライアントは、パラメタとして以下のものを指定します。

エントリの追

 エントリを追加する場合は、以下の関数を使用します。

 ディレクトリツリー上にエントリを追加する場合、クライアントは、パラメタとして以下のものを指定します。

エントリの削

 エントリを削除する場合、以下の関数を使用します。

 エントリの削除では、クライアントはパラメタとして、エントリのDNを指定します。

 

非同期操作の取消

 非同期型の関数を使用してSmart Repositoryサーバに要求を送信した場合、以下の関数を使用することにより、要求を取り消すことができます。

 非同期要求を取り消す場合には、取り消したい非同期要求のメッセージIDを指定します。メッセージIDは、非同期要求を発行する際に通知されます。
 ldap_abandon()、またはldap_abandon_ext()を発行した時点で、取り消したい非同期要求のresult情報をすでに受信していた場合は、そのresult情報は破棄されます。


目次 索引 前ページ次ページ

All Rights Reserved, Copyright(C) 富士通株式会社 2005