ldap_request_partition_sync

Schedules synchronization of the specified partition after the specified delay.

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_request_partition_sync (
     LDAP   *ld, 
     char   *serverDN, 
     char   *partitionRoot, 
     int     delay);

Parameters

ld: (IN) Points to the handle for the LDAP session.
serverDN: (IN) Points to distinguished name, in LDAP format, of the server containing the partition.
partitionRoot: (IN) Points to the distinguished name, in LDAP format, of the partition root to synchronize.
delay: (IN) Specifies the time, in seconds, to delay before synchronization starts.

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

In eDirectory, this function causes the server to examine its Transitive Vector attribute, and the server initiates synchronization with those servers whose replica update time is older than the local time stamp.

For sample code, see parsync.c.

Packet Format

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

  RequestBer
      serverName       LDAPDN
      partitionRoot    LDAPDN
      delay            INTEGER

The responseName is set to the OID (2.16.840.1.113719.1.27.100.26) and the responseValue has no value.