Table of Contents | Previous | Next | Index

Netscape Directory SDK 3.0 for C Programmer’s Guide
     Chapter 18 Functions

ldap_next_entry()

Returns a pointer to the LDAPMessage structure representing the next directory entry in a chain of search results.

Syntax

#include <ldap.h>
LDAPMessage * ldap_next_entry( LDAP *ld, LDAPMessage *entry );

Parameters

This function has the following parameters:

ld

Connection handle, which is a pointer to an LDAP structure containing information about the connection to the LDAP server.

entry

Pointer to an LDAPMessage structure in a chain of search results.

Returns

One of the following values:

Description

The ldap_next_entry() function returns a pointer to the LDAPMessage structure representing the next directory entry in a chain of search results. Messages containing directory entries have the type LDAP_RES_SEARCH_ENTRY.

You can use this function in conjunction with the ldap_first_entry() function to iterate through the directory entries in a chain of search results. These functions skip over any messages in the chain that do not have the type LDAP_RES_SEARCH_ENTRY.

For more information, see "Iterating Through a Chain of Results" on page 124.

See Also

ldap_first_entry().


Table of Contents | Previous | Next | Index

Last Updated: 10/01/98 17:06:23