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

Voir aussi

Fonctions

Recherche dans un répertoire

ldap_first_attribute

ldap_first_entry

ldap_get_values_len

ldap_next_attribute

ldap_next_entry

ldap_value_free