función ldap_first_entry (winldap.h)
La función ldap_first_entry devuelve la primera entrada de un mensaje.
Sintaxis
WINLDAPAPI LDAPMessage *LDAPAPI ldap_first_entry(
[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 entrada de resultados. 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_entry junto con ldap_next_entry para recorrer y recuperar la lista de entradas de una cadena de resultados de búsqueda.
No es necesario liberar explícitamente la entrada 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 |