fonction ldap_get_values_len (winldap.h)
La fonction ldap_get_values_len récupère la liste des valeurs d’un attribut donné.
Syntaxe
WINLDAPAPI berval **LDAPAPI ldap_get_values_len(
[in] LDAP *ExternalHandle,
[in] LDAPMessage *Message,
[in] const PSTR attr
);
Paramètres
[in] ExternalHandle
Handle de session.
[in] Message
Gérez la structure LDAPMessage .
[in] attr
Pointeur vers une chaîne terminée par null qui contient l’attribut dont les valeurs doivent être récupérées.
Valeur retournée
Si la fonction réussit, elle retourne une liste null de pointeurs vers des structures berval qui contiennent les valeurs de l’attribut spécifié. Si aucune valeur d’attribut n’a été trouvée, elle retourne NULL. Le paramètre d’erreur de session dans la structure de données LDAP est défini sur 0 dans les deux cas.
Si la fonction échoue, elle retourne NULL et le paramètre d’erreur de session dans la structure de données LDAP est défini sur le code d’erreur LDAP.
Remarques
Utilisez ldap_get_values_len lors de l’analyse d’une réponse de recherche pour obtenir la ou les valeurs d’un attribut. Utilisez cette fonction lorsque l’attribut contient des données binaires ; pour les attributs dont les valeurs sont des chaînes de caractères terminées par null, utilisez ldap_get_values.
L’entrée est obtenue en appelant ldap_first_entry ou ldap_next_entry. L’attribut doit être retourné par un appel à ldap_first_attribute, ldap_next_attribute ou une chaîne fournie par l’appelant (par exemple, « mail »).
Appelez ldap_value_free_len pour libérer la valeur retournée lorsqu’elle n’est plus nécessaire.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |