ldap_delete_ext (Windows CE 5.0)

Send Feedback

This function is an extended routine that removes a leaf entry from the directory tree.

ULONG ldap_delete_ext(LDAP* ld,UNICODE PTCHARdn,LDAPControl** ServerControls,LDAPControl** ClientControls,ULONG* MessageNumber);

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.
  • MessageNumber
    [out] Message identifier for the request.

Return Values

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

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

If the operation succeeds, ldap_delete_ext passes the message identifier to the caller as a parameter when the operation returns successfully. Call the ldap_result function with the message identifier to get the result of the operation.

If you prefer to have the function return the results directly, use the synchronous routine ldap_delete_ext_s.

In a multithreading environment, calls to ldap_delete_ext are thread-safe.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Winldap.h.
Link Library: Wldap32.lib.

See Also

LDAP_RETCODE | ldap_delete | ldap_delete_ext_s | ldap_result

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.