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

Vea también

Funciones

ldap_msgfree