InfoDirectory使用手引書

5.2.7.3 ldap_compare_ext

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

【指定形式】

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

【パラメタの説明】

• ld

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

• dn

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

• attr

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

• bvalue

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

• serverctrls

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

• clientctrls

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

• msgidp

  　メッセージIDを格納するための変数のアドレスを指定します。

【復帰値】

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

• 正常完了の場合 ： LDAP_SUCCESS
• 異常完了の場合 ： LDAP_SUCCESS以外のLDAPエラーコード

　また、正常完了の場合には、msgidpパラメタで指定した変数にメッセージIDが設定されています。

【注意事項】

• 比較可能な属性値

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

• 非同期関数の結果獲得

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

• サーバコントロール

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

• LDAPエラーコード

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