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

1.20.12.5 ldap_next_attribute()

名前

　ldap_next_attribute

形式

　#include "idldap.h"
　char  *ldap_next_attribute(
　        LDAP  *ld,
　        LDAPMessage  *entry,
　        BerElement  *ber );

機能説明

　この関数は、直前のldap_first_attribute()、またはldap_next_attribute()で通知された属性名の、次の属性名を通知します。

パラメタ

　ld

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

　entry

　直前のldap_first_attribute()、またはldap_next_attribute()と同じ、エントリのアドレスを指定します。

　ber

　直前のldap_first_attribute()、またはldap_next_attribute()で使用した、BerElement構造体のアドレスを指定します。

復帰値

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

• 正常終了の場合 ： 次の属性名のアドレス
• 異常終了の場合 ： NULL

  　正常終了の場合、berパラメタが示すBerElement構造体の内容が更新されます。
  　異常終了の場合のエラー原因は、ldap_get_option()のLDAP_OPT_RESULT_CODEオプションで参照してください。

  　なお、次の属性名がない場合にも、復帰値としてNULLを返します。

注意事項

• 動的メモリの解放

  　ldap_next_attribute()が復帰値として返した属性名の領域は、不要になった時点でldap_memfree()を使用して解放しなければなりません。詳細は、“動的メモリの解放インタフェース”を参照してください。