Edit

ldap_count_entries function (winldap.h)

  • Article

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

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_count_entries(
  [in] LDAP        *ld,
  [in] LDAPMessage *res
);

Parameters

[in] ld

The session handle.

[in] res

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

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header winldap.h
Library Wldap32.lib
DLL Wldap32.dll

See also

Functions

ldap_count_references

ldap_count_values

ldap_first_entry

ldap_first_reference

ldap_next_entry

ldap_next_reference

ldap_result