ldap_add_s()--Perform an LDAP Add Operation (Synchronous)

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

The ldap_add_s() function is used to perform synchronous 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

LDAP_SUCCESS

if the request was successfully sent.

another LDAP error code

if the request was not successfully sent.

Error Conditions

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

Error Messages

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

Related Information

    ldap_add() -- Asynchronously add an entry.
    ldap_add_ext_s() -- Synchronously add an entry with controls.
    ldap_add_ext() -- Asynchronously add an entry with controls.
    ldap_modify_s() -- Synchronously modify an entry.