ldap_add 函数 (winldap.h)

ldap_add 函数启动对目录树的异步添加操作。要使添加操作成功，添加的项的父级必须存在，或者父项必须为空 (等于根) 的可分辨名称。

语法

WINLDAPAPI ULONG LDAPAPI ldap_add(
  [in] LDAP         *ld,
  [in] PSTR         dn,
  [in] LDAPMod * [] attrs
);

[in] ld

会话句柄。

[in] dn

指向以 null 结尾的字符串的指针，该字符串包含要添加的条目的可分辨名称。

[in] attrs

指向 LDAPMod 结构的指针数组。每个结构指定一个属性。

如果函数成功，则返回添加操作的消息 ID。

如果函数失败，它将返回 –1 并在 LDAP 数据结构中设置会话错误参数。若要检索错误数据，请使用 LdapGetLastError。

在调用 ldap_add 之前，请在 LDAPMod 结构中指定条目的属性来创建条目。将每个结构的 mod_op 成员设置为LDAP_MOD_ADD，并根据需要为条目设置 mod_type 和 mod_vals 成员。

作为异步函数， ldap_add 返回操作的消息 ID。使用消息 ID 调用 ldap_result 以获取操作的结果。若要在异步添加操作完成之前取消该操作，请调用 ldap_abandon。

若要直接返回结果，请使用同步函数 ldap_add_s。使用 ldap_add_ext 或 ldap_add_ext_s 启用对 LDAP 3 服务器和客户端控件的支持。

多线程处理：对 ldap_add 的调用是线程安全的，前提是在函数调用返回 -1 失败代码时使用 LdapGetLastError 检索实际会话错误代码。

注意连接到 LDAP 2 服务器时，应用程序必须通过调用 ldap_bind 或 ldap_simple_bind 例程之一来执行绑定操作，然后再尝试其他操作。