ldap_abort_partition_operation

Aborts the last partition operation on 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_abort_partition_operation (
     LDAP   *ld, 
     char   *dn, 
     int     flags);

Parameters

ld: (IN) Points to the handle for the LDAP session.
dn: (IN) Points to the distinguished name, in LDAP format, of partition whose current operation should be aborted.
flags: (IN) Set to zero. Not currently used.

Return Values

0x00	LDAP_SUCCESS or no partition operation is pending.
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, partition operations include

Adding, changing, and removing replicas
Joining and splitting partitions

At any given time, only one partition operation is pending. If a partition operation is not pending when this function is called, the function returns LDAP_SUCCESS.

For sample code, see abortpo.c.

Packet Format

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

  RequestBer
      flags       INTEGER
      dn          LDAPDN

The responseName is set to the OID (2.16.840.1.113719.1.27.100.30) and there is no responseValue.

  ResponseBer
      NULL