ldap_add_ext 函数 (winldap.h)
ldap_add_ext 函数启动对树的异步添加操作。 添加的项的父级必须存在,或者父项必须为空 (等于根) 的可分辨名称,才能使添加操作成功。
WINLDAPAPI ULONG LDAPAPI ldap_add_ext(
[in] LDAP *ld,
[in] const PSTR dn,
[in] LDAPModA * [] attrs,
[in] PLDAPControlA *ServerControls,
[in] PLDAPControlA *ClientControls,
[out] ULONG *MessageNumber
);
[in] ld
会话句柄。
[in] dn
指向以 null 结尾的字符串的指针,该字符串包含要添加的条目的可分辨名称。
[in] attrs
指向 LDAPMod 结构的指针数组。 每个结构指定单个属性。 有关详细信息,请参见“备注”部分。
[in] ServerControls
LDAP 服务器控件的列表。
[in] ClientControls
客户端控件列表。
[out] MessageNumber
请求的消息 ID。
如果函数成功,则返回 LDAP_SUCCESS 。
如果函数失败,则返回错误代码。 有关详细信息,请参阅错误处理。
ldap_add_ext的参数和效果包括ldap_add的参数和效果。 扩展例程包括其他参数,以支持客户端和服务器控件以及线程安全。
在调用 ldap_add_ext 之前,请在 LDAPMod 结构中指定条目的属性来创建条目。 将每个结构的 mod_op 字段设置为 LDAP_MOD_ADD,并根据需要设置 mod_type 字段和 mod_vals 字段。
如果操作成功, ldap_add_ext 将消息 ID 作为参数传递给调用方。 使用消息 ID 调用 ldap_result 以获取操作的结果。
若要直接返回结果,请使用同步函数 ldap_add_ext_s。
多线程:对 ldap_add_ext 的调用是线程安全的。
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | winldap.h |
Library | Wldap32.lib |
DLL | Wldap32.dll |
函数