ldap_next_reference()

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

#include <ldap.h>
LDAPMessage * ldap_next_reference( LDAP *ld, LDAPMessage *ref );

If successful, returns the pointer to the next LDAPMessage structure of the type LDAP_RES_SEARCH_REFERENCE in a chain of search results.

If no more LDAPMessage structures of the type LDAP_RES_SEARCH_REFERENCE are in the chain or if the function is unsuccessful, returns a NULLMSG.

The ldap_next_reference() function returns a pointer to the LDAPMessage structure representing the next search reference in a chain of search results. Messages containing search references have the type LDAP_RES_SEARCH_REFERENCE.

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

ld	Connection handle, which is a pointer to an `LDAP` structure containing information about the connection to the LDAP server.
msg	Pointer to an `LDAPMessage` structure in a chain of search results.