ldap_lburp_operation_request

Sends an LBURP operation request extended operation to the 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_lburp_operation_request(                LDAP *ld,                int sequenceNumber,                LBURPUpdateOperationList **updateList,                int *msgID)

Parameters

ld

(IN) Points to the handle for the LDAP session.

sequenceNumber

(IN) Points to the sequenceNumber used to specify the ordering of the LBURP operation.

updateList

(IN) Points to an array of LDAPMod structures along with package ID, that contain the attributes and values to add/delete/modify/modify rdn entries.

msgidp

(OUT) Points to the message ID of the request when the add request succeeds.

Return Values

0x00

LDAP_SUCCESS

Non-zero

Failure. For a complete list, see LDAP Return Codes.

0x53

LDAP_ENCODING_ERROR

0x5A

LDAP_NO_MEMORY

Remarks

The sequence number is used to specify the ordering of LBURP operation requests. This enables the client to know the order in which the LBURP operation requests must be processed even if it receives them in a sequence different from that in which they were sent from the client. The cilent must set the value of sequence number of the first LBURP operation to 1, and must increment the value of sequence number for each succeeding LBURP operation.

To obtain the results of the operation, call the ldap_result function with the returned message ID.

See Also