ldap_get_replication_filter

Gets the replication filter defined for an eDirectory server.

LDAP Version:v3

Library:*ldapx.*

NDS Version:8.5, SP1

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_replication_filter (
     LDAP   *ld, 
     char   *serverDN, 
     char   **filter);

Parameters

ld: (IN) Points to the handle for the LDAP session.
serverDN: (IN) Points to the distinguished name of the server from which to read the replication filter.
filter: (OUT) Points to the address of the filter. For the format, see Section 6.6, Replication Filters. The returned filter must be freed by calling the ldapx_memfree function.

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
0x59	LDAP_PARAM_ERROR
0x5A	LDAP_NO_MEMORY
0x5C	LDAP_NOT_SUPPORTED
Non-zero	Non-zero values indicate errors. See LDAP Return Codes.

Remarks

An eDirectory server can only have one replication filter, and that filter is used for all filtered replicas on the server.

NDS eDirectory 8.5 and above supports filtered replicas. The extension to get and set the replication filter is not available until NDS 8.5 SP1.

Packet Format

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

  RequestBer
      serverName    LDAPDN

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