ldap_modify 函数 (winldap.h)

ldap_modify 函数更改现有条目。

语法

WINLDAPAPI ULONG LDAPAPI ldap_modify(
  [in] LDAP          *ld,
  [in] PSTR          dn,
  [in] LDAPModA * [] mods
);

[in] ld

会话句柄。

[in] dn

指向以 null 结尾的字符串的指针，该字符串包含要修改的条目的名称。

[in] mods

要对条目执行的以 null 结尾的修改数组。

如果函数成功，它将返回修改操作的消息 ID。

如果函数失败，它将返回 –1 并在 LDAP 数据结构中设置会话错误参数。

ldap_modify 函数启动异步操作以修改现有条目。如果在条目中添加或替换值，函数将创建属性（如有必要）。如果正在删除值，并且没有保留任何值，则函数将删除该属性。所有修改均按其列出顺序执行。

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

如果希望函数直接返回结果，请使用同步例程 ldap_modify_s。如果需要 LDAP 3 服务器和客户端控件的支持，请使用 ldap_modify_ext 或 ldap_modify_ext_s 。

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

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