Share via


ldap_delete_ext_s

A version of this page is also available for

Windows Embedded CE 6.0 R3

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_RETCODE enumeration 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_s function. The extended routine includes additional parameters to support client and server controls and thread safety.

As a synchronous function, ldap_delete_ext_s returns when the delete operation is complete. Use ldap_delete or ldap_delete_ext if you want the delete operation to be carried out asynchronously.

In a multithreading environment, calls to ldap_delete_ext_s are 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

Reference

LDAP_RETCODE
ldap_delete
ldap_delete_ext
ldap_delete_s