Interstage Application Server Smart Repository運用ガイド

6.2.7.1 ldap_compare

　この関数は、非同期型の属性値比較処理を行います。

【指定形式】

int  ldap_compare(
        LDAP  *ld,
        char  *dn,
        char  *attr,
        char  *value
        );

【パラメタの説明】

• ld

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

• dn

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

• attr

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

• value

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

【復帰値】

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

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

  　異常完了の場合、以下の原因が考えられます。

  • パラメタの指定に誤りがあります。
  • 使用可能なメモリが不足しました。

【注意事項】

• 比較可能な属性値

  　ldap_compare()では、バイナリ値の比較はできません。

• 非同期関数の結果獲得

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

• SSLエラーコード

  　ldapssl_init()で獲得したセションハンドルを使用している場合、SSLライブラリで発生したエラーをldapssl_error()で参照することができます。