ldap_insert_control()--Insert a Control in the Llist of LDAP Server Controls

 #include <ldap.h>
 
 int ldap_insert_control(
              LDAPControl *newControl,
              LDAPControl ***ctrlList)

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 i5/OS authority is required. All authority checking is done by the LDAP server.

Parameters

newControl

(Input) Specifies the LDAP server control to be inserted. See LDAP Controls for more information about server controls.

ctrlList

(Input) Specifies a list of LDAP server controls. See LDAP Controls 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.