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

1.20.12.7 ldap_get_values_len()

名前

　ldap_get_values_len

形式

　#include "idldap.h"
　struct berval  **ldap_get_values_len(
　        LDAP  *ld,
　        LDAPMessage  *entry,
　        const char  *attr );

機能説明

　この関数は、指定されたエントリの属性値を、バイナリデータとして読み込みます。

パラメタ

　ld

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

　entry

　ldap_first_entry()、またはldap_next_entry()によって通知された、エントリのアドレスを指定します。

　attr

　属性名のアドレスを指定します。
　ldap_first_attribute()、またはldap_next_attribute()によって通知された属性名を指定することができます。

復帰値

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

• 正常終了の場合 ： 属性値のポインタ配列のアドレス
• 異常終了の場合 ： NULL

  　異常終了の場合のエラー原因は、ldap_get_option()のLDAP_OPT_RESULT_CODEオプションで参照してください。
  　なお、指定された属性がなかった場合にも、復帰値としてNULLを返します。

注意事項

• 動的メモリの解放

  　ldap_get_values_len()の復帰値として通知されたポインタ配列は、不要になった時点で、ldap_value_free_len()を使用して解放しなければなりません。詳細は、“動的メモリの解放インタフェース”を参照してください。