InfoDirectory使用手引書

5.2.7.4 ldap_compare_ext_s

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

【指定形式】

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

【パラメタの説明】

• ld

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

• dn

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

• attr

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

• bvalue

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

• serverctrls

  　サーバコントロールのアドレスを設定した、ポインタ配列のアドレスを指定します。サーバコントロールを使用しない場合は、このパラメタにNULLを指定します。ここで指定したサーバコントロールは、InfoDirectoryサーバへの比較要求に添付されます。

• clientctrls

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

【復帰値】

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

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

【注意事項】

• 比較可能な属性値

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

• サーバコントロール

  　サーバコントロールの形式については、LDAPコントロールを参照してください。

• LDAPエラーコード

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