ldap_next_entry()
Purpose
Return the next search entry in an LDAP result
Format
#include <ldap.h>
LDAPMessage * ldap_next_entry(
LDAP * ld,
LDAPMessage * msg)
Parameters
Input
- ld
- Specifies the LDAP handle.
- msg
- Specifies the LDAP message returned by the ldap_first_entry() routine.
Usage
The ldap_next_entry() routine returns the address of the next search entry in an LDAP result.
Function return value
The function return value is the address of the next search entry.
The return value is NULL
if there are no more search entries
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 search
entries.
The following is a common error for this routine:
LDAP_PARAM_ERROR
- A parameter is not valid.