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

 #include <ldap.h>
 
 int ldap_add_s(
         LDAP           *ld,
         const char     *dn,
         LDAPMod        **attrs)

The ldap_add_s() function is used to perform synchronous LDAP add operation.

Authorities and Locks

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

Parameters

ld

(Input) 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.

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 sent from this function.

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.