ldap_get_replica_info

Returns information about the specified replica on the specified directory server.

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_get_replica_info (
     LDAP                 *ld, 
     char                 *dn, 
     char                 *serverDN, 
     struct LDAPReplicaInfo   *partitionInfo);

Parameters

ld: (IN) Points to the handle for the LDAP session.
dn: (IN) Points to the distinguished name, in LDAP format, of the replica from which information is being requested.
serverDN: (IN) Points to the distinguished name, in LDAP format, of the server containing the replica.
partitionInfo: (OUT) Points to a LDAPReplicaInfo structure that returns with the replica information.

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

The specified server holding the replica must be running or an error is returned.

For sample code, see getrinfo.c.

Packet Format

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

  RequestBer
      serverName        LDAPDN
      dn                LDAPDN

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