función ldap_next_reference (winldap.h)
La función ldap_next_reference recupera una referencia de una cadena de resultados de búsqueda.
Sintaxis
WINLDAPAPI LDAPMessage *LDAPAPI ldap_next_reference(
[in] LDAP *ld,
[in] LDAPMessage *entry
);
Parámetros
[in] ld
Identificador de sesión.
[in] entry
Entrada devuelta por una llamada anterior a ldap_first_reference o ldap_next_reference.
Valor devuelto
Si la búsqueda devolvió resultados válidos, esta función devuelve un puntero a la siguiente entrada de resultados del conjunto de resultados. Si no existen más entradas o referencias en el conjunto de resultados, devuelve NULL. Este es el único error devuelto; El parámetro de error de sesión de la estructura de datos LDAP se borra en 0 en cualquier caso.
Comentarios
Use ldap_next_reference junto con ldap_first_reference para recorrer y recuperar una lista de referencias de continuación de una cadena de resultados de búsqueda.
La función devuelve referencias subordinadas (referencias) que se devuelven en las respuestas de búsqueda. Una referencia subordinada es aquella en la que el servidor ha devuelto algunos datos y la referencia se ha pasado a otros contextos de nomenclatura por debajo del nivel actual del árbol. Para recorrer las referencias externas en las que el contexto de nomenclatura no reside en el servidor, use ldap_parse_result.
No es necesario liberar explícitamente la referencia devuelta, ya que se libera cuando se libera el propio mensaje.
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 |