ldap_compare_sW函数 (winldap.h)

使用 ldap_compare_s 函数来确定给定条目的属性是否包含已知值。

语法

WINLDAPAPI ULONG LDAPAPI ldap_compare_sW(
  [in] LDAP        *ld,
  [in] const PWSTR dn,
  [in] const PWSTR attr,
  [in] PWSTR       value
);

参数

[in] ld

会话句柄。

[in] dn

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

[in] attr

指向包含要比较的属性的以 null 结尾的字符串的指针。

[in] value

指向以 null 结尾的字符串的指针,其中包含要与属性值进行比较的字符串属性值。

返回值

如果函数成功,并且属性和已知值匹配,则返回值 LDAP_COMPARE_TRUE。 如果值不匹配,则返回值 LDAP_COMPARE_FALSE

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

言论

ldap_compare_s 函数启动同步比较操作,将特性的值与已知的字符串值进行比较。 如果需要比较二进制值,请使用 ldap_compare_ext_s。 使用 ldap_compareldap_compare_ext 执行异步比较操作。

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

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

注意

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

要求

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

另请参阅

Functions

返回值

ldap_bind

ldap_compare

ldap_compare_ext

ldap_compare_ext_s

ldap_simple_bind