ldap_insert_control()--Insert a Control in the Llist of LDAP Server Controls
Syntax
#include <ldap.h> int ldap_insert_control( LDAPControl *newControl, LDAPControl ***ctrlList)
Library Name/Service Program: QSYS/QGLDCLNT
Default Public Authority: *USE
Threadsafe: Yes
The ldap_insert_control() function is used to insert a control in the list of LDAP server controls.
Note: The function will allocate space in the list for the control, but will not allocate the actual control.
Authorities and Locks
No IBM® i authority is required. All authority checking is done by the LDAP server.
Parameters
- newControl
- (Input) Specifies the LDAP server control to be inserted. See Controls for LDAP APIs for more information about server controls.
- ctrlList
- (Input) Specifies a list of LDAP server controls. See Controls for LDAP APIs for more information about server controls.
Return Value
- LDAP_SUCCESS
- if the request was successful.
- LDAP_NO_MEMORY
- if the control could not be inserted.
Related Information
- ldap_add_control() -- Add a new LDAP server control.
- ldap_remove_control() -- Remove a control from the list of LDAP server controls.
- ldap_copy_controls() -- Synchronously add an entry with controls.
API introduced: V5R3
[ Back to top | LDAP APIs | APIs by category ]