ldap_escape_filter_element 函数将筛选器元素转换为可以安全地在搜索筛选器中传递的以 null 结尾的字符串。
语法
WINLDAPAPI ULONG LDAPAPI ldap_escape_filter_elementW(
[in] PCHAR sourceFilterElement,
[in] ULONG sourceLength,
[out] PWCHAR destFilterElement,
[in] ULONG destLength
);
参数
[in] sourceFilterElement
指向包含要转换的筛选器元素的 null 终止字符串的指针。
[in] sourceLength
源筛选器元素的长度（以字节为单位）。
[out] destFilterElement
指向以 null 结尾的字符串的指针。
[in] destLength
destFilterElement 缓冲区的长度（以字节为单位）。
返回值
如果函数成功，则返回值 LDAP_SUCCESS。
如果函数失败，它将返回错误代码。 有关详细信息，请参阅 返回值。
言论
ldap_escape_filter_element 函数允许在搜索筛选器中使用原始二进制数据。 例如，可以使用此函数将证书或 JPEG 映像指定为要匹配的属性。
使用指向原始数据的 sourceFilterElement 参数调用 ldap_escape_filter_element，并将 sourceLength 正确设置为数据的长度。 如果 destFilterElement 参数 NULL，则返回值为输出缓冲区所需的长度。 如果 destFilterElement 未 NULL，则该函数会将源复制到目标缓冲区并确保其采用安全格式。 然后在“attributetype=”筛选器元素之后将目标缓冲区插入搜索筛选器。
注意 不要为字符串的属性值调用 ldap_escape_filter_element，因为运行时不执行 UTF-8 格式的任何转换。 仅将此函数用于原始二进制数据的属性元素。
注意
winldap.h 标头将ldap_escape_filter_element定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista |
| 支持的最低服务器 | Windows Server 2008 |
| 目标平台 | 窗户 |
| 标头 | winldap.h |
| 库 | Wldap32.lib |
| DLL | Wldap32.dll |