función ldap_get_values_len (winldap.h)
La función ldap_get_values_len recupera la lista de valores de un atributo determinado.
Sintaxis
WINLDAPAPI berval **LDAPAPI ldap_get_values_len(
[in] LDAP *ExternalHandle,
[in] LDAPMessage *Message,
[in] const PSTR attr
);
Parámetros
[in] ExternalHandle
Identificador de sesión.
[in] Message
Identificador de la estructura LDAPMessage .
[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 estructuras berval que contienen los valores del atributo especificado. Si no se encontraron valores de atributo, devuelve NULL. 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_len al analizar una respuesta de búsqueda para obtener el valor o los valores de un atributo. Use esta función cuando el atributo contenga datos binarios; para atributos cuyos valores son cadenas de caracteres terminadas en NULL, use ldap_get_values.
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").
Llame a ldap_value_free_len para liberar el valor devuelto cuando ya no sea necesario.
Requisitos
| Requisito | Value |
|---|---|
| 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 |