función ldap_get_values (winldap.h)

Artículo
03/08/2023

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