ldap_compare_ext_s函数 (winldap.h)

使用 ldap_compare_ext_s 函数来确定给定条目的属性是否保留已知值。

语法

WINLDAPAPI ULONG LDAPAPI ldap_compare_ext_s(
  [in] LDAP          *ld,
  [in] const PSTR    dn,
  [in] const PSTR    Attr,
  [in] const PSTR    Value,
  [in] berval        *Data,
  [in] PLDAPControlA *ServerControls,
  [in] PLDAPControlA *ClientControls
);

参数

[in] ld

会话句柄。

[in] dn

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

[in] Attr

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

[in] Value

指向包含要与属性值进行比较的字符串属性值的 null 终止字符串的指针。 如果未使用,则设置为 NULL

[in] Data

要与属性值进行比较的 属性值。 如果未使用,则设置为 NULL

[in] ServerControls

自选。 LDAP 服务器控件的列表。 如果未使用,则设置为 NULL

[in] ClientControls

自选。 LDAP 客户端控件的列表。 如果未使用,则设置为 NULL

返回值

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

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

言论

ldap_compare_ext_s 函数启动同步比较作,将特性的值与已知值进行比较。 ldap_compare_ext_sldap_compare_s的参数和效果。 扩展例程包括用于支持客户端和服务器控件的其他参数,以及二进制值的比较。

使用 Value 参数来比较字符串值,或使用 Data 参数来比较原始二进制数据。 将未使用的参数设置为 NULL。 如果两个参数都不 NULL,则比较作将使用 Data 参数中的值。

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

要求

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

另请参阅

扩展控件

Functions

返回值

使用控件

伯瓦尔

ldap_compare_s