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 |
另请参阅
返回值