ldap_controls_free()--Free storage allocated by the LDAP library

Syntax

 #include <ldap.h>
 
 void ldap_controls_free(LDAPControl  **ctrls)

  Library Name/Service Program: QSYS/QGLDCLNT

  Default Public Authority: *USE

  Threadsafe: Yes

The ldap_controls_free() routine is used to free storage allocated by the LDAP APIs that uses an array of LDAPControl structure.

Authorities and Locks

No IBM^® i authority is required.

ctrls: (Input) The address of an LDAPControl list, represented as a NULL-terminated array of pointers to LDAPControl structures.

None.

The ldap_controls_free() API does not return an error code.

The following message may be sent from this function.

Message ID	Error Message Text
CPF3CF2 E	Error(s) occurred during running of ldap_controls_free API.

ldap_ber_free() -- Free storage allocatd for BerElement structure.
ldap_memfree() -- Free storage that has been allocated by the LDAP client library.
ldap_control_free() -- Free a single LDAPControl structure.
ldap_msgfree() -- Free LDAP Result Message.
ldap_mods_free() -- Free an array of pointers to mod structures.
ldap_parse_result() -- Extract Information from Results

API introduced: V4R5