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

Voir aussi

Fonctions

LDAPMessage

berval

ldap_first_attribute

ldap_first_entry

ldap_get_values

ldap_next_attribute

ldap_next_entry

ldap_value_free_len