使用 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_s 子 ldap_compare_s的参数和效果。 扩展例程包括用于支持客户端和服务器控件的其他参数,以及二进制值的比较。
使用 Value 参数来比较字符串值,或使用 Data 参数来比较原始二进制数据。 将未使用的参数设置为 NULL。 如果两个参数都不 NULL,则比较作将使用 Data 参数中的值。
多线程处理:对 ldap_compare_ext_s 的调用是线程安全的。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista |
支持的最低服务器 | Windows Server 2008 |
目标平台 | 窗户 |
标头 | winldap.h |
库 | Wldap32.lib |
DLL | Wldap32.dll |