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

1.20.5.1 ldap_compare()

名前

　ldap_compare

形式

　#include "idldap.h"
　int  ldap_compare(
　        LDAP  *ld,
　        const char  *dn,
　        const char  *attr,
　        const char  *value );

機能説明

　この関数は、非同期型の属性値比較処理をします。ldap_compare()では、バイナリ値の比較はできません。バイナリ値の比較をする場合は、ldap_compare_ext()を使用してください。

　非同期型検索の処理結果を受け取る場合、ldap_result()を使用します。この時、ldap_compare()の復帰値として返されたメッセージIDを指定します。詳細は、“処理結果の受取り/判定”を参照してください。

パラメタ

　ld

　ldap_init()で通知された、セションハンドルを指定します。

　dn

　比較を行うエントリのDNのアドレスを指定します。

　attr

　比較を行う属性の名前のアドレスを指定します。

　value

　比較対象の文字列データのアドレスを指定します。

復帰値

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

• 正常終了の場合 ： メッセージID
• 異常終了の場合 ： -1

  　異常終了の場合のエラー原因は、ldap_get_option()のLDAP_OPT_RESULT_CODEオプションで参照してください。