ldap_control_free

The ldap_control_free function frees an LDAPControl structure.

ULONG ldap_control_free(
  LDAPControl* Control
);

Parameters

Control

[in] The LDAPControl structure to free.

Return Values

If the function succeeds, LDAP_SUCCESS is returned.

If the function fails, an error code is returned. For more information, see Return Values.

Remarks

Use this function to free an LDAPControl structure previously allocated by an LDAP function call, such as one allocated by a call to ldap_create_page_control or ldap_create_vlv_control.

Note  This function should only be used to free a control created internally by LDAP API functions. It is not used to free memory that is explicitly allocated by the user program.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Unicode: Implemented as Unicode and ANSI versions on all platforms.
Header: Declared in Winldap.h.
Library: Use Wldap32.lib.

See Also

Functions, LDAPControl, ldap_create_page_control, ldap_create_vlv_control, Return Values