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.