ldap_add_ext_s()--Perform an LDAP Add Operation with Controls (Synchronous)
Syntax
#include <ldap.h> int ldap_add_ext_s(LDAP *ld, const char *dn, LDAPMod **attr, LDAPControl **serverctrls, LDAPControl **clientctrls)
Library Name/Service Program: QSYS/QGLDCLNT
Default Public Authority: *USE
Threadsafe: Yes
The ldap_add_ext_s() function is used to perform synchronous LDAP add operation with controls.
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.
- serverctrls
- (Input) A list of LDAP server controls. This parameter may be set
to null. See Controls for LDAP APIs for more information
about server controls.
- clientctrls
- (Input) A list of LDAP client controls. This parameter may be set to null. See Controls for LDAP APIs for more information about client controls.
Return Value
- LDAP_SUCCESS
- if the request was successful.
- another LDAP error code
- if the request was not successful.
Error Conditions
The ldap_add_ext_s() will return an LDAP error code if not successful. 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_ext_s API. |
Related Information
- ldap_add() -- Asynchronously add an entry.
- ldap_add_s() -- Synchronously add an entry.
- ldap_add_ext() -- Asynchronously add an entry with controls.
- ldap_modify_ext_s() -- Synchronously modify an entry with controls.
The ldap_add_ext_s() API supports LDAP V3 server controls and client controls.
API introduced: V4R5
[ Back to top | LDAP APIs | APIs by category ]