fonction ldap_create_vlv_controlA (winldap.h)
La fonction ldap_create_vlv_control est utilisée pour créer le contrôle de requête (LDAP_CONTROL_VLVREQUEST) sur le serveur.
Syntaxe
WINLDAPAPI INT LDAPAPI ldap_create_vlv_controlA(
[in] PLDAP ExternalHandle,
[in] PLDAPVLVInfo VlvInfo,
[in] UCHAR IsCritical,
[out] PLDAPControlA *Control
);
Paramètres
[in] ExternalHandle
Un handle de session LDAP, tel qu’obtenu à partir d’un appel à ldap_init.
[in] VlvInfo
Adresse d’une structure LDAPVLVInfo dont le contenu est utilisé pour construire la valeur du contrôle créé.
[in] IsCritical
Si cette valeur n’est pas égale à zéro, le contrôle créé aura sa valeur critique définie sur TRUE.
[out] Control
Un paramètre de résultat a affecté l’adresse d’une structure LDAPControl qui contient le contrôle de requête (LDAP_CONTROL_VLVREQUEST) créé par cette fonction.
Valeur de retour
La fonction ldap_create_vlv_control retourne un code d’erreur LDAP pour indiquer l’échec ou LDAP_SUCCESS en cas de réussite.
Remarques
Lorsqu’une recherche VLV est effectuée, le client doit utiliser cette fonction pour créer un contrôle VLV qui peut être inclus dans la demande de recherche envoyée au serveur. Le serveur affecte un contextID pour cette recherche VLV, transmise au client. Une fois la recherche VLV terminée, vous devez utiliser ldap_control_free pour libérer le contrôle retourné par ldap_create_vlv_controlet ldap_controls_free pour libérer le tableau de contrôles, y compris le contrôle de réponse VLV, retourné par ldap_parse_result.
Pour plus d’informations et un exemple de code pour cette fonction, consultez Exemple de code pour l’utilisation de LDAP VLV.
Note
L’en-tête winldap.h définit ldap_create_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 |