Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function counts the number of subordinate references that were returned by the server in a response to a search request.

Syntax

ULONG ldap_count_references(
  LDAP* 
ld,
  LDAPMessage* 
res
);

Parameters

ld

[in] Session handle.

res

[in] Search result obtained by a call to one of the synchronous search routines or to the ldap_resultfunction.

Return Value

If this function succeeds, it returns the number of references.

If this function fails, it returns –1 and sets the session error parameters in the LDAP data structure.

Remarks

This function returns the number of references contained in a chain of search results. It can also be used to count the number of references that remain in a chain. Call the function with the return value from ldap_first_entry, ldap_next_entry, ldap_first_reference, ldap_next_reference, or ldap_result.

Requirements

Header winldap.h
Library wldap32.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also