Export (0) Print
Expand All
Expand Minimize

ldap_count_references function

The ldap_count_references 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(
  _In_  LDAP *ld,
  _In_  LDAPMessage *res
);

Parameters

ld [in]

The session handle.

res [in]

The search result obtained by a call to one of the synchronous search routines or to ldap_result.

Return value

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

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

Remarks

The ldap_count_references 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

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

Winldap.h

Library

Wldap32.lib

DLL

Wldap32.dll

See also

Functions
ldap_count_entries
ldap_count_values
ldap_first_entry
ldap_first_reference
ldap_next_entry
ldap_next_reference
ldap_result

 

 

Show:
© 2014 Microsoft