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.