ldap_modify_ext 函数 (winldap.h)
ldap_modify_ext 函数更改现有条目。
语法
WINLDAPAPI ULONG LDAPAPI ldap_modify_ext(
[in] LDAP *ld,
[in] const PSTR dn,
[in] LDAPModA * [] mods,
[in] PLDAPControlA *ServerControls,
[in] PLDAPControlA *ClientControls,
[out] ULONG *MessageNumber
);
参数
[in] ld
会话句柄。
[in] dn
指向以 null 结尾的字符串的指针，该字符串包含要修改的条目的名称。
[in] mods
要对条目进行修改的以 null 结尾的数组。
[in] ServerControls
LDAP 服务器控件的列表。
[in] ClientControls
客户端控件列表
[out] MessageNumber
如果调用成功，此 result 参数将设置为请求的消息 ID。
返回值
如果函数成功，则返回值 LDAP_SUCCESS。
如果函数失败，它将返回错误代码。 有关详细信息 ，请参阅返回值 。
注解
ldap_modify_ext 函数启动异步操作以修改现有条目。 如果在条目中添加或替换值，函数将创建 属性（如有必要）。 如果正在删除值，并且没有保留任何值，则 函数将删除 特性。 所有修改都按其列出顺序执行。
ldap_modify_ext的参数和效果与ldap_modify的参数和效果并列。 扩展例程包括用于支持客户端和服务器控制以及线程安全性的其他参数。
如果成功， ldap_modify_ext 在 MessageNumber 参数中传回操作的消息 ID。 使用消息 ID 调用 ldap_result 以获取操作的结果。 如果希望函数直接返回结果，请使用同步扩展函数 ldap_modify_ext_s。
多线程处理：对 ldap_modify_ext 的调用是线程安全的。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | winldap.h |
| Library | Wldap32.lib |
| DLL | Wldap32.dll |
另请参阅
返回值