función ldap_get_values (winldap.h)
La función ldap_get_values recupera la lista de valores de un atributo determinado.
Sintaxis
WINLDAPAPI PCHAR *LDAPAPI ldap_get_values(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[in] const PSTR attr
);
Parámetros
[in] ld
Identificador de sesión.
[in] entry
Entrada de la que se van a recuperar los valores.
[in] attr
Puntero a una cadena terminada en null que contiene el atributo cuyos valores se van a recuperar.
Valor devuelto
Si la función se ejecuta correctamente, devuelve una lista terminada en null de punteros a valores. Si no se encontraron valores de atributo, normalmente devuelve NULL. Pero, en algunos casos, puede devolver una lista de un puntero que es NULL. Asegúrese siempre de usar ldap_count_values para obtener el recuento de valores de la lista devuelta, como se indica en Comentarios. El parámetro de error de sesión de la estructura de datos LDAP se establece en 0 en cualquier caso.
Si se produce un error en la función, devuelve NULL y el parámetro de error de sesión de la estructura de datos LDAP se establece en el código de error LDAP.
Comentarios
Use ldap_get_values al analizar una respuesta de búsqueda para obtener el valor o los valores de un atributo. Use esta función solo cuando el atributo contenga cadenas de caracteres terminadas en NULL; para datos binarios, use ldap_get_values_len en su lugar.
La entrada se obtiene llamando a ldap_first_entry o ldap_next_entry. El atributo debe ser uno devuelto por una llamada a ldap_first_attribute, ldap_next_attribute o una cadena proporcionada por el autor de la llamada (por ejemplo, "mail").
Use ldap_count_values para obtener el recuento de valores de la lista devuelta. Llame a ldap_value_free para liberar el valor devuelto cuando ya no sea necesario.
Determinados servidores LDAP colocan límites en el número de valores de cadena de atributo que se devuelven en una sola llamada. Para obtener más información sobre el uso de especificadores de recuperación de intervalos, vea Buscar mediante recuperación de intervalos.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | winldap.h |
| Library | Wldap32.lib |
| Archivo DLL | Wldap32.dll |