ldap_add_ext()--Perform an LDAP Add Operation with Controls

Syntax #include <ldap.h> int ldap_add_ext( LDAP *ld, char *dn, LDAPMod *attrs[], LDAPControl **serverctrls, LDAPControl **clientctrls, int *msgidp) Threadsafe: Yes

The ldap_add_ext() function is used to perform an LDAP add operation with controls.

Authorities and Locks

No OS/400 authority is required. All authority checking is done by the LDAP server.

Parameters

ld

(Input) Specifies the LDAP pointer returned by a previous call to ldap_init(),ldap_ssl_init(), or ldap_open().

dn

(Input) The DN of the entry to add

attrs

(Input) The entry's attributes, specified using the LDAPMod structure, as defined for ldap_modify(). The mod_type and mod_vals fields should be filled in. The mod_op field is ignored unless ORed with the constant LDAP_MOD_BVALUES. In this case, the mod_op field is used to select the mod_bvalues case of the mod_vals union.

serverctrls

(Input) Specifies a list of LDAP server controls. This parameter may be set to null. See LDAP Controls for more information about server controls.

clientctrls

(Input) Specifies a list of LDAP client controls. This parameter may be set to null. See LDAP Controls for more information about client controls.

msgidp

(Output) This result parameter is set to the message id of the request if the ldap_add_ext() call succeeds.

Note that all entries except that specified by the last component in the given DN must already exist.

Return Value

LDAP_SUCCESS

if the request was successful. If successful, ldap_add_ext() places the message id of the request in *msgidp. A subsequent call to ldap_result() can be used to obtain the result of the operation. Once the operation has completed.

another LDAP error code

if the request was not successful.

Error Conditions

If ldap_add_ext() is not successful, LDAP error code will be returned. See LDAP Client API Error Conditions for possible LDAP error code values. The error code indicates if the operation completed successfully. The ldap_parse_result() API is used to check the error code in the result.

Error Messages

    The following message may be set from this function.
    CPF3CF2 E  Error(s) occurred during running of ldap_add_ext API.

Related Information

    ldap_add() -- Asynchronously add an entry.
    ldap_add_s() -- Synchronously add an entry.
    ldap_add_ext_s() -- Synchronously add an entry with controls.
    ldap_modify_ext() -- Asynchronously modify an entry with controls.

The ldap_add_ext() API support LDAP V3 server controls and client controls.