ldap_remove_control()--Remove a Control from the List of LDAP Server Controls

 #include <ldap.h>
 
 int ldap_remove_control(
              LDAPControl *delControl,
              LDAPControl ***ctrlList,
              int         freeit)

The ldap_remove_control() function is used to remove a control from the list of LDAP server controls.

Note: If freeit is not 0, the control will be freed. If freeit is set to 0, the control will not be freed.

Authorities and Locks

No i5/OS authority is required. All authority checking is done by the LDAP server.

Parameters

delControl

(Input) Specifies the control to be deleted. 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.

freeit

(Input) Specifies whether or not to free the control. If set to TRUE, the control will be freed. If set to FALSE, the control will not be freed.

Return Value

LDAP_SUCCESS

if the request was successful.

LDAP_NO_MEMORY

if the control could not be removed.

Related Information

• ldap_insert_control() -- Insert a control in the list of LDAP server controls.
• ldap_add_control() -- Add a new LDAP server control.
• ldap_copy_controls() -- Synchronously add an entry with controls.