ldap_modify_sW函数 (winldap.h)

ldap_modify_s 函数更改现有条目。

语法

WINLDAPAPI ULONG LDAPAPI ldap_modify_sW(
  [in] LDAP          *ld,
  [in] PWSTR         dn,
  [in] LDAPModW * [] mods
);

参数

[in] ld

会话句柄。

[in] dn

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

[in] mods

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

返回值

如果函数成功,则返回值 LDAP_SUCCESS

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

言论

ldap_modify_s 函数启动同步操作以修改现有条目。 如果在条目中添加或替换值,函数将在必要时创建属性。 如果正在删除值,则函数将删除该属性(如果未保留任何值)。 所有修改都按列出顺序执行。

多线程处理:对 ldap_modify_s 的调用是线程安全的。

注意 连接到 LDAP 2 服务器时,应用程序必须在尝试任何其他操作之前(通过调用其中一个 ldap_bindldap_simple_bind 例程)执行绑定操作。
 

注意

winldap.h 标头将ldap_modify_s定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

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

另请参阅

Functions

LDAP

LDAPMod

修改目录项

返回值

ldap_bind

ldap_modify

ldap_modify_ext

ldap_modify_ext_s

ldap_simple_bind