LDAPMessage structures representing search references in a chain of search results.
#include <ldap.h>
int ldap_count_references( LDAP *ld, LDAPMessage *res );
ld |
Connection handle, which is a pointer to an |
result |
Chain of search results, represented by the pointer to an |
LDAPMessage structures of the type LDAP_RES_SEARCH_REFERENCE in a chain of search results, if successful. (If there are no structures of this type, returns 0.) ld is not a valid connection handle. ldap_count_references() function returns the number of LDAPMessage structures representing search references in a chain of search results. These messages have the type LDAP_RES_SEARCH_REFERENCE.
Note that if you pass in a pointer to an LDAPMessage structure in the middle of the chain of results, the function counts only the references between that structure and the last structure in the chain. In this type of situation, the function does not return the count of all references in the chain.
For more information on using this function, see "Iterating Through a Chain of Results" on page 124
ldap_search_ext() and ldap_search_ext_s().
ldap_result(), ldap_search_ext(), ldap_search_ext_s(), ldap_first_reference(), ldap_next_reference().
Last Updated: 10/01/98 17:06:23