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

Syntax

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

Library Name/Service Program: QSYS/QGLDCLNT

Default Public Authority: *USE

Threadsafe: Yes

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

Authorities and Locks

No IBM^® i 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.

Message ID	Error Message Text
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.

API introduced: V4R3

[ Back to top | LDAP APIs | APIs by category ]