InfoDirectory使用手引書 |
目次 索引 |
第3部 SDK編 | > 第5章 アプリケーション開発環境(LDAP C API) | > 5.2 関数インタフェース | > 5.2.16 メッセージリスト処理 |
この関数は、ldap_result()で通知されたメッセージリスト内の、先頭のメッセージのアドレスを通知します。【指定形式】
LDAPMessage *ldap_first_message(
LDAP *ld,
LDAPMessage *res
);【パラメタの説明】
- ld
ldap_init()またはldapssl_init()で通知された、セションハンドルを指定します。
- res
ldap_result()または同期型の検索処理で通知された、メッセージリストのアドレスを指定します。
【復帰値】
この関数は、復帰値として以下の値を返します。
- 正常完了の場合 : 先頭のメッセージアドレス
- 異常完了の場合 : NULL
【注意事項】
- 獲得したメッセージのアドレス
ldap_first_message()で通知されたメッセージのアドレスは、以下の関数においてパラメタとして使用することができます。
- メッセージリスト処理
- エラー情報の取得処理(result情報の場合)
- 継続リファレンスの処理
ldap_first_reference()
ldap_next_reference()
ldap_count_references()- エントリリストの処理
目次 索引 |