fonction ldap_get_values (winldap.h)
La fonction ldap_get_values récupère la liste des valeurs d’un attribut donné.
Syntaxe
WINLDAPAPI PCHAR *LDAPAPI ldap_get_values(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[in] const PSTR attr
);
Paramètres
[in] ld
Handle de session.
[in] entry
Entrée à partir de laquelle récupérer des valeurs.
[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 valeurs. Si aucune valeur d’attribut n’a été trouvée, elle retourne généralement NULL. Toutefois, dans certains cas, il peut renvoyer une liste un pointeur null. Veillez toujours à utiliser ldap_count_values pour obtenir le nombre de valeurs dans la liste retournée, comme indiqué dans Remarques. 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 lors de l’analyse d’une réponse de recherche pour obtenir la ou les valeurs d’un attribut. Utilisez cette fonction uniquement lorsque l’attribut contient des chaînes de caractères terminées par null ; pour les données binaires, utilisez plutôt ldap_get_values_len .
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 »).
Utilisez ldap_count_values pour obtenir le nombre de valeurs dans la liste retournée. Appelez ldap_value_free pour libérer la valeur retournée lorsqu’elle n’est plus nécessaire.
Certains serveurs LDAP placent des limites sur le nombre de valeurs de chaîne d’attribut retournées dans un seul appel. Pour plus d’informations sur l’utilisation des spécificateurs de récupération de plage, consultez Recherche à l’aide de la récupération de plage.
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 |