fonction ldap_parse_page_control (winldap.h)
Le ldap_parse_page_control analyse les résultats d’une recherche dans des pages.
Syntaxe
WINLDAPAPI ULONG LDAPAPI ldap_parse_page_control(
[in] PLDAP ExternalHandle,
[in] PLDAPControlA *ServerControls,
[out] ULONG *TotalCount,
[out] berval **Cookie
);
Paramètres
[in] ExternalHandle
Handle de session.
[in] ServerControls
Tableau de contrôles qui comprend un contrôle de page. Le contrôle de page contient les champs cookie et total count retournés par le serveur.
[out] TotalCount
Pointeur vers le nombre total d’entrées retournées dans cette page (facultatif).
[out] Cookie
Cookie opaque, utilisé par le serveur pour déterminer son emplacement dans le jeu de résultats. Utilisez ber_bvfree pour libérer.
Valeur retournée
Si la fonction réussit, la valeur de retour est LDAP_SUCCESS.
Si la fonction échoue, elle retourne un code d'erreur. Pour plus d’informations, consultez Valeurs de retour .
Remarques
Utilisez ldap_parse_page_control conjointement avec ldap_create_page_control et ldap_parse_result pour implémenter la pagination simple des résultats au moyen de contrôles. Après avoir appelé ldap_parse_page_control pour récupérer les contrôles serveur et extraire le cookie du résultat de la recherche, appelez ldap_parse_result pour analyser les résultats. Utilisez ensuite le cookie pour appeler ldap_create_page_control afin de récupérer la page de résultats suivante.
Configuration requise
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | winldap.h |
| Bibliothèque | Wldap32.lib |
| DLL | Wldap32.dll |