ldap_add()--Perform an LDAP Add Operation

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

The ldap_add() function is used to perform an LDAP add operation.

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.

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

Return Value

Message ID of the operation initiated

if the request was successfully sent. A subsequent call to ldap_result(), can be used to obtain the result of the operation.

-1

if the request was not successful.

Error Conditions

If ldap_add() is not successful, ld_errno will be set to indicate the error. See LDAP Client API Error Conditions for possible LDAP error code values. ldap_get_errno() function to retrieve the error information.

Error Messages

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

Related Information

    ldap_add_s() -- Synchronously add an entry.
    ldap_add_ext() -- Asynchronously add an entry with controls.
    ldap_add_ext_s() -- Synchronously add an entry with controls.
    ldap_modify() -- Asynchronously modify an entry.