Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function is an extended routine that performs a synchronous operation to remove a leaf entry from the directory tree.

Syntax 

ULONG ldap_delete_ext_s(
  LDAP* 
ld,
  UNICODE PTCHAR 
dn,
  LDAPControl** 
ServerControls,
  LDAPControl** 
ClientControls
);

Parameters

ld

[in] Session handle.

dn

[in] Distinguished name of the entry to delete.

ServerControls

[in] List of LDAP server controls.

ClientControls

[in] List of client controls.

Return Value

If this function succeeds, the return value is LDAP_SUCCESS.

If this function fails, it returns an error code. See the LDAP_RETCODEenumeration for a list of possible return values.

Remarks

Call this function to remove a leaf entry from the directory tree.

Note:
LDAP does not support deletion of entire subtrees in a single operation.

The parameters and effects of this function include those of the ldap_delete_sfunction. The extended routine includes additional parameters to support client and server controls and thread safety.

As a synchronous function, ldap_delete_ext_sreturns when the delete operation is complete. Use ldap_deleteor ldap_delete_extif you want the delete operation to be carried out asynchronously.

In a multithreading environment, calls to ldap_delete_ext_sare thread-safe.

Requirements

Header winldap.h
Library wldap32.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also