función ldap_result (winldap.h)
La función ldap_result obtiene el resultado de una operación asincrónica.
Sintaxis
WINLDAPAPI ULONG LDAPAPI ldap_result(
[in] LDAP *ld,
[in] ULONG msgid,
[in] ULONG all,
[in] PLDAP_TIMEVAL timeout,
[out] PLDAPMessage *res
);
Parámetros
[in] ld
Identificador de sesión.
[in] msgid
El identificador del mensaje de la operación o la constante LDAP_RES_ANY si se requiere algún resultado.
[in] all
Especifica cuántos mensajes se recuperan en una sola llamada a ldap_result. Este parámetro solo tiene significado para los resultados de la búsqueda. Pase el LDAP_MSG_ONE constante (0x00) para recuperar un mensaje a la vez. Pase LDAP_MSG_ALL (0x01) para solicitar que se reciban todos los resultados de una búsqueda antes de devolver todos los resultados en una sola cadena. Pase LDAP_MSG_RECEIVED (0x02) para indicar que todos los resultados recuperados hasta ahora deben devolverse en la cadena de resultados.
[in] timeout
Tiempo de espera que especifica cuánto tiempo, en segundos, se va a esperar a que se devuelvan los resultados. Un valor NULL hace que ldap_result bloquee hasta que los resultados estén disponibles. Un valor de tiempo de espera de cero segundos especifica un comportamiento de sondeo.
[out] res
Contiene los resultados de la operación. Los resultados devueltos deben liberarse con una llamada a ldap_msgfree una vez que la aplicación ya no los requiera.
Valor devuelto
Si la función se realiza correctamente, devuelve uno de los valores siguientes para indicar el tipo del primer resultado en el parámetro res . Si el tiempo de espera expira, la función devuelve 0.
Si se produce un error en la función, devuelve –1 y establece los parámetros de error de sesión en la estructura de datos LDAP.
Comentarios
La función ldap_result recupera el resultado de una operación iniciada de forma asincrónica anterior. Tenga en cuenta que, en función de la forma en que se llame, ldap_result puede devolver realmente una lista o una "cadena" de mensajes.
Para LDAP sin conexión, debe pasar un identificador de conexión LDAP y un identificador de mensaje para asegurarse de que obtiene los resultados correctos. El tiempo de ejecución de LDAP continúa enviando la solicitud hasta que recibe una respuesta.
Multithreading: las llamadas a ldap_result son seguras para subprocesos.
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 |