Interstage Application Server Smart Repository運用ガイド

6.2.7.4 ldap_compare_ext_s

　この関数は、同期型の属性値比較処理を行います。この関数では、LDAPコントロールを指定することができます。

【指定形式】

int  ldap_compare_ext_s(
        LDAP  *ld,
        char  *dn,
        char  *attr,
        struct berval  *bvalue,
        LDAPControl  **serverctrls,
        LDAPControl  **clientctrls
        );

【パラメタの説明】

• ld

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

• dn

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

• attr

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

• bvalue

  　比較対象のデータを設定したberval構造体のアドレスを指定します。

• serverctrls

  　Smart Repositoryではサーバコントロールをサポートしていないため、このパラメタにはNULLを指定します。

• clientctrls

  　本ライブラリではクライアントコントロールをサポートしていないため、このパラメタにはNULLを指定します。

【復帰値】

　この関数では、復帰値としてLDAPエラーコードを返します。

• LDAP_COMPARE_TRUE（正常完了）の場合 ： 指定された属性に、bvalueパラメタで指定された値が含まれています。
• LDAP_COMPARE_FALSE（正常完了）の場合 ： 指定された属性には、bvalueパラメタで指定された値が含まれていません。
• 異常完了の場合 ： 上記以外のLDAPエラーコードが通知されます。

【注意事項】

• 比較可能な属性値

  　ldap_compare_ext_s()では、文字列データとバイナリデータの比較を行うことができます。

• LDAPエラーコード

  　LDAPエラーコードの値については、“LDAPエラーコード”を参照してください。

• SSLエラーコード

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