fonction ldap_parse_vlv_controlA (winldap.h)
La fonction ldap_parse_vlv_control est utilisée pour rechercher et analyser les résultats de recherche VLV.
Syntaxe
WINLDAPAPI INT LDAPAPI ldap_parse_vlv_controlA(
[in] PLDAP ExternalHandle,
[in] PLDAPControlA *Control,
[out] PULONG TargetPos,
[out] PULONG ListCount,
[out] PBERVAL *Context,
[out] PINT ErrCode
);
Paramètres
[in] ExternalHandle
Handle de session LDAP.
[in] Control
Adresse d’un tableau de LDAPControl terminée par NULL, généralement obtenue par un appel à ldap_parse_result.
[out] TargetPos
Position numérique de l’entrée cible dans la liste des jeux de résultats, telle que fournie par l’élément targetPosition du contrôle de réponse encodé BER (LDAP_CONTROL_VLVRESPONSE). Si ce paramètre est NULL, la position cible n’est pas retournée.
[out] ListCount
Estimation du serveur du nombre d’entrées dans la liste, comme indiqué par l’élément contentCount du contrôle de réponse encodé en BER (LDAP_CONTROL_VLVRESPONSE). Si ce paramètre est NULL, la taille n’est pas retournée.
[out] Context
Identificateur de contexte généré par le serveur. Si le serveur ne retourne pas d’identificateur de contexte, ce paramètre est défini sur NULL. Si NULL est passé pour contextp, l’identificateur de contexte n’est pas retourné.
[out] ErrCode
Code de résultat VLV, tel que fourni par l’élément virtualListViewResult du contrôle de réponse encodé en BER (LDAP_CONTROL_VLVRESPONSE). Si ce paramètre est NULL, le code de résultat n’est pas retourné.
Valeur de retour
Cette fonction retourne un code d’erreur LDAP qui indique si un contrôle de résultat VLV a été trouvé et analysé correctement. LDAP_SUCCESS est retourné si tout va bien, LDAP_CONTROL_MISSING est retourné si les ctrls tableau n’incluent pas de contrôle de réponse (LDAP_CONTROL_VLVRESPONSE), et un autre code d’erreur LDAP est retourné si une erreur d’analyse ou un autre problème se produit.
VLV utilise les codes de valeur de retour LDAP suivants :
LDAP_OPERATIONS_ERROR
LDAP_UNWILLING_TO_PERFORM
LDAP_INSUFFICIENT_ACCESS
LDAP_BUSY
LDAP_TIMELIMIT_EXCEEDED
LDAP_ADMINLIMIT_EXCEEDED
LDAP_OTHER
En outre, les deux codes suivants ont été ajoutés pour prendre en charge VLV :
Remarques
Ce contrôle analyse les résultats de recherche retournés par le serveur dans le contrôle de réponse (LDAP_CONTROL_VLVRESPONSE). Un identificateur de contexte est transmis du serveur au client pour identifier le contrôle, qui doit être libéré à la fin de la session en appelant ber_bvfree.
Pour plus d’informations et un exemple de code, consultez Exemple de code pour l’utilisation du VLV LDAP.
Note
L’en-tête winldap.h définit ldap_parse_vlv_control en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| serveur minimum pris en charge | Windows Server 2008 |
| plateforme cible | Windows |
| d’en-tête | winldap.h |
| bibliothèque | Wldap32.lib |
| DLL | Wldap32.dll |