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

1.20.11.8 ldap_next_message()

名前

　ldap_next_message

形式

　#include "idldap.h"
　LDAPMessage  *ldap_next_message(
　        LDAP  *ld,
　        LDAPMessage  *msg );

機能説明

　この関数は、直前のldap_first_message()、またはldap_next_message()で通知されたメッセージの、次のメッセージのアドレスを通知します。

　ldap_next_message()で通知されたメッセージのアドレスは、以下の関数においてパラメタとして使用することができます。

• メッセージリスト処理

  　ldap_next_message()
  　ldap_count_messages()

• エラー情報の取得処理（result情報の場合）

  　ldap_parse_result()

• エントリリストの処理

  　ldap_first_entry()
  　ldap_next_entry()
  　ldap_count_entries()

パラメタ

　ld

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

　msg

　直前のldap_first_message()、またはldap_next_message()で通知された、メッセージのアドレスを指定します。

復帰値

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

• 正常終了の場合 ： 次のメッセージのアドレス
• 異常終了の場合 ： NULL

  　異常終了の場合のエラー原因は、ldap_get_option()のLDAP_OPT_RESULT_CODEオプションで参照してください。

  　なお、次のメッセージがない場合にも、復帰値としてNULLを返します。