función ldap_first_reference (winldap.h)
La función ldap_first_reference devuelve la primera referencia de un mensaje.
Sintaxis
WINLDAPAPI LDAPMessage *LDAPAPI ldap_first_reference(
[in] LDAP *ld,
[in] LDAPMessage *res
);
Parámetros
[in] ld
Identificador de sesión.
[in] res
Resultado de la búsqueda, como se obtiene mediante una llamada a una de las rutinas de búsqueda sincrónicas o ldap_result.
Valor devuelto
Si la búsqueda devolvió resultados válidos, esta función devuelve un puntero a la primera referencia de resultado. Si no existe ninguna entrada o referencia 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_first_reference junto con ldap_next_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 en su lugar.
No es necesario liberar explícitamente la referencia devuelta, ya que se libera cuando se libera el propio mensaje.
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 |