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 ]