función ldap_next_attribute (winldap.h)
Para una entrada determinada, la función ldap_next_attribute devuelve el atributo siguiente.
Sintaxis
WINLDAPAPI PCHAR LDAPAPI ldap_next_attribute(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[in, 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.
[in, out] ptr
Dirección de un puntero utilizado internamente para realizar un seguimiento de la posición actual en la entrada.
Valor devuelto
Si la función se ejecuta correctamente, devuelve un puntero a una cadena terminada en null que contiene el nombre del atributo actual. Si 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_next_attribute junto con ldap_first_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_next_attribute devuelve, a través del parámetro ptr , un puntero a una estructura BerElement . Pase este puntero a la siguiente llamada 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.
La función ldap_next_attribute devuelve un puntero a un búfer asignado internamente 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
| 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 |