ldap_next_message()
Purpose
Return the next LDAP message in an LDAP result
Format
#include <ldap.h>
LDAPMessage * ldap_next_message(
LDAP * ld,
LDAPMessage * msg)
Parameters
Input
- ld
- Specifies the LDAP handle.
- msg
- Specifies the LDAP message returned by the ldap_first_message() routine.
Usage
The ldap_next_message() routine returns the address of the next message in an LDAP result.
Function return value
The function return value is the address of the next message. The
return value is NULL
if there are no more messages or if
an error is detected. The ldap_get_errno() routine
can be called to get the error code when the return value is NULL
.
The error code is LDAP_SUCCESS
if there are no more messages.
The following is a common error for this routine:
LDAP_PARAM_ERROR
- A parameter is not valid.