ldap_next_message()--Retrieve Next LDAP Message

Syntax #include <ldap.h> LDAPMessage *ldap_next_message(LDAP *ld, LDAPMessage *msg) Threadsafe: Yes

The ldap_next_message() routine is used to step through the list of messages in a result chain, as returned by ldap_result(). It is used to return a pointer to the next message from the list.

Authorities and Locks

No OS/400 authority is required. All authority checking is done by the LDAP server.

Parameters

ld

(Input) Specifies the LDAP pointer returned by a previous call to ldap_init(),ldap_ssl_init(), or ldap_open().

msg

(Input) Specifies the message returned by a previous call to ldap_first_message() or ldap_next_message().

Return Value

LDAPMessage *

pointer to the next message in list.

NULL

when no more messages exist in the result set to be returned or if an error occurs.

Error Conditions

If ldap_next_message() is not successful, ld_errno will be set to indicate the error. See LDAP Client API Error Conditions for possible LDAP error code values. Use ldap_get_errno() function to retrieve the error information.

Error Messages

    The following message may be set from this function.
    CPF3CF2 E  Error(s) occurred during running of ldap_next_message API.

Related Information

    ldap_count_message() -- Return the number of message in a result chain, as returned by ldap_result.
    ldap_first_message() -- Return first message in a result chain, as returned by ldap_result.