Directory Services

ldap_count_entries

The ldap_count_entries function counts the number of search entries that a server returned.

ULONG ldap_count_entries(
  LDAP* ld,
  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 Values

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

If the function fails, the return value is –1 and the function sets the session error parameters in the LDAP data structure.

Remarks

The ldap_count_entries function returns the number of entries contained, or remaining in a chain of entries. Call the function with the return value from ldap_first_entry, ldap_next_entry, ldap_first_reference, ldap_next_reference, or ldap_result.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Winldap.h.
Library: Use Wldap32.lib.

See Also

Functions, ldap_count_references, ldap_count_values, ldap_first_entry, ldap_first_reference, ldap_next_entry, ldap_next_reference, ldap_result