ldap_add_ext_s 函数 (winldap.h)

项目
08/27/2023

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

语法

WINLDAPAPI ULONG LDAPAPI ldap_add_ext_s(
  [in] LDAP          *ld,
  [in] const PSTR    dn,
  [in] LDAPModA * [] attrs,
  [in] PLDAPControlA *ServerControls,
  [in] PLDAPControlA *ClientControls
);

参数

[in] ld

会话句柄。

[in] dn

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

[in] attrs

指向 LDAPMod 结构的指针数组。每个结构指定一个属性。有关详细信息，请参见“备注”部分。

[in] ServerControls

LDAP 服务器控件的列表。

[in] ClientControls

客户端控件的列表。

返回值

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

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

注解

ldap_add_ext_s的参数和效果包括ldap_add_s的参数和效果。扩展例程包括支持客户端和服务器控件的其他参数。

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

完成添加操作后， ldap_add_ext_s 返回给调用方。如果希望异步完成操作，请使用 ldap_add_ext 。

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

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

ServerControls 和 ClientControls 是可选的，如果未使用，则应设置为 NULL 。

要求

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