ldap_add_s 函数 (winldap.h)

ldap_add_s 函数启动同步添加操作，将条目添加到树中。要添加的条目的父项必须已存在，或者父项必须为空， (等于根可分辨名称) ，添加操作才能成功。

语法

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

[in] ld

会话句柄。

[in] dn

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

[in] attrs

指向 LDAPMod 结构的指针的以 null 结尾的数组。每个结构指定单个属性。有关更多信息，请参见备注。

如果函数成功，则返回值 LDAP_SUCCESS。

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

调用 ldap_add_s 之前。必须通过在 LDAPMod 结构中指定条目的属性来创建条目。将每个结构的 mod_op 成员设置为LDAP_MOD_ADD，并根据需要为条目设置 mod_type 和 mod_vals 成员。有关详细信息，请参阅修改目录条目。

完成添加操作后， ldap_add_s 将返回到调用方。如果希望异步执行操作，请使用 ldap_add 。

多线程处理：对 ldap_add_s 的调用是线程安全的。

注意连接到 LDAP 2 服务器时，应用程序必须在尝试任何其他操作之前) 调用ldap_bind或 ldap_simple_bind例程之一， (执行绑定操作。

返回值