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

Syntax

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

  Library Name/Service Program: QSYS/QGLDCLNT

  Default Public Authority: *USE

  Threadsafe: Yes

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 IBM^® i authority is required. All authority checking is done by the LDAP server.

Parameters

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

API introduced: V5R3

[ Back to top | LDAP APIs | APIs by category ]