ldap_parse_page_control将搜索结果分析为页面。
语法
WINLDAPAPI ULONG LDAPAPI ldap_parse_page_controlA(
[in] PLDAP ExternalHandle,
[in] PLDAPControlA *ServerControls,
[out] ULONG *TotalCount,
[out] berval **Cookie
);
参数
[in] ExternalHandle
会话句柄。
[in] ServerControls
包含页控件的控件数组。 页面控件包含服务器返回的 Cookie 和总计计数字段。
[out] TotalCount
指向此页面中返回的条目总数的指针 (可选) 。
[out] Cookie
一个不透明的 Cookie，由服务器用来确定其在结果集中的位置。 使用ber_bvfree释放。
返回值
如果函数成功，则 返回值LDAP_SUCCESS。
如果该函数失败，它将返回错误代码。 有关详细信息 ，请参阅返回值 。
注解
将 ldap_parse_page_control 与 ldap_create_page_control 和 ldap_parse_result 结合使用，通过控件实现结果的简单分页。 调用 ldap_parse_page_control 以检索服务器控件并从搜索结果中提取 Cookie 后，调用 ldap_parse_result 以分析结果。 然后使用 Cookie 调用 ldap_create_page_control 以检索下一页结果。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | winldap.h |
| Library | Wldap32.lib |
| DLL | Wldap32.dll |