ldap_delete_extA 函数 (winldap.h)

ldap_delete_ext 函数是一个扩展例程,用于从目录树中删除叶项。

语法

WINLDAPAPI ULONG LDAPAPI ldap_delete_extA(
  [in]  LDAP          *ld,
  [in]  const PSTR    dn,
  [in]  PLDAPControlA *ServerControls,
  [in]  PLDAPControlA *ClientControls,
  [out] ULONG         *MessageNumber
);

参数

[in] ld

会话句柄。

[in] dn

指向以 null 结尾的字符串的指针,该字符串包含要删除的条目的可分辨名称。

[in] ServerControls

可选。 LDAP 服务器控件的列表。 如果未使用,请将此参数设置为 NULL。

[in] ClientControls

可选。 客户端控件列表。 如果未使用,请将此参数设置为 NULL

[out] MessageNumber

请求的消息 ID。

返回值

如果函数成功,则返回 LDAP_SUCCESS

如果函数失败,则返回错误代码。 有关详细信息,请参阅 返回值

注解

ldap_delete_ext 函数从目录树中删除叶条目。 LDAP 不支持在单个操作中删除整个子树,但有一个扩展控件 (LDAP_SERVER_TREE_DELETE_OID)用于执行此操作。

ldap_delete_ext的参数和效果包括ldap_delete的参数和效果。 扩展例程包括用于支持客户端和服务器控件以及线程安全的参数。

如果操作成功, ldap_delete_ext 操作成功返回时将消息 ID 作为参数传递给调用方。 若要获取操作的结果,请使用消息 ID 调用 ldap_result

若要使函数直接返回结果,请使用同步例程 ldap_delete_ext_s

多线程处理:对 ldap_delete_ext 的调用是线程安全的。

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 winldap.h
Library Wldap32.lib
DLL Wldap32.dll

另请参阅

扩展控件

函数

修改目录条目

返回值

使用控件

ldap_delete

ldap_delete_ext_s

ldap_result