función ldap_first_attribute (winldap.h)
Para una entrada de directorio determinada, la función ldap_first_attribute devuelve el primer atributo.
Sintaxis
WINLDAPAPI PCHAR LDAPAPI ldap_first_attribute(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[out] BerElement **ptr
);
Parámetros
[in] ld
Identificador de sesión.
[in] entry
Entrada cuyos atributos se van a recorrer, tal y como devuelve ldap_first_entry o ldap_next_entry.
[out] ptr
Dirección de un puntero utilizado internamente para realizar un seguimiento de la posición actual en la entrada.
Valor devuelto
Un puntero a una cadena terminada en null. Si la función se realiza correctamente, devuelve un puntero a un búfer asignado que contiene el nombre del atributo actual. Cuando no hay más atributos para recorrer paso a paso, 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 establece el parámetro de error de sesión en la estructura de datos LDAP en el código de error LDAP.
Comentarios
Use ldap_first_attribute junto con ldap_next_attribute para recorrer la lista de tipos de atributo devueltos con una entrada. A continuación, puede pasar estos nombres de atributo en una llamada a ldap_get_values para recuperar sus valores asociados.
Una llamada a ldap_first_attribute asigna y devuelve a través del parámetro ptr , un puntero a una estructura BerElement . Pase este puntero a ldap_next_attribute para realizar un seguimiento de la posición actual en la lista de atributos. Cuando haya terminado de recorrer una lista de atributos y ptr no sea NULL, libere el puntero llamando a ber_free( ptr, 0 ). Tenga en cuenta que debe pasar el segundo parámetro como 0 (cero) en esta llamada.
Tanto ldap_first_attribute comoldap_next_attribute devuelven un puntero a un búfer asignado que contiene el nombre del atributo actual. Libere este búfer, cuando ya no sea necesario, llamando a ldap_memfree. Dado que este búfer se sobrescribe en la siguiente llamada a ldap_first_attribute o
ldap_next_attribute, el usuario debe realizar una copia del nombre del atributo si se debe conservar para su procesamiento.
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 |