ldap_count_references

Returns the number of LDAPMessage structures in an LDAP result message chain that are of type LDAP_RES_SEARCH_REFERENCE.

LDAP Version:v3

Library:*ldapsdk.*

NDS Version:7.xx or higher

Platform:NLM, Windows (NT, 95, 98, 2000, XP, Vista 32-bit and 64-bit ), Linux (32-bit and 64-bit), Solaris, AIX, and HP-UX

Syntax

  #include <ldap.h>
  
  int ldap_count_references (
     LDAP          *ld,
     LDAPMessage   *res);

Parameters

ld: (IN) Points to the handle for the LDAP session.
res: (IN) Points to the result chain returned by the ldap_result function or a synchronous search function.

Return Values

>0	Number of references
0	No more references
-1	Failure

Remarks

This function counts from the current position of the pointer to the end of the chain.

If you pass a pointer that points to the first message structure in the chain, it counts all the references in the chain.
If you pass a pointer that points to a structure in the middle of the chain, it counts the references from that point to the end of the chain.

See Also

ldap_first_reference, ldap_next_reference, ldap_search, ldap_search_ext, ldap_search_ext_s, ldap_search_s, ldap_search_st