ldap_partition_entry_count

Returns the number of entries in the specified partition.

LDAP Version:v3

Library:*ldapx.*

NDS Version:8.5

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 <ldapx.h>
  
  int ldap_partition_entry_count (
     LDAP            *ld, 
     char            *dn, 
     unsigned long   *count);

Parameters

ld: (IN) Points to the handle for the LDAP session.
dn: (IN) Points to the distinguished name, in LDAP format, of an entry in the partition whose entries are to be counted.
count: (OUT) Points to the address where the count is returned.

Return Values

0x00	LDAP_SUCCESS
0x01	LDAP_OPERATIONS_ERROR: A string is returned with this error code that indicates the source of the error.
0x53	LDAP_ENCODING_ERROR
0x5A	LDAP_NO_MEMORY
0x5C	LDAP_NOT_SUPPORTED
Non-zero	Non-zero values indicate errors. See LDAP Return Codes.

Remarks

This function stops at the boundary of the partition. It does not cross the boundary and count the entries in child partitions.

If this function is called immediately after creating a new partition, the count will be inaccurate until the partition moves from the new state (LDAP_RS_NEW_REPLICA) to the on state (LDAP_RS_ON).

For sample code, see getcount.c.

Packet Format

The requestName is set to the OID (2.16.840.1.113719.1.27.100.13) and the requestValue is a BER encoding of the following:

  RequestBer
     dn     LDAPDN

The responseName is set to the OID (2.16.840.1.113719.1.27.100.14) and the responsetValue is a BER encoding of the following: