ldap_add_ext 函数 (winldap.h)

项目
2024/03/13

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 的调用是线程安全的。

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

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

要求

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