función cldap_open (winldap.h)
La función cldap_open establece una sesión con un servidor LDAP a través de un servicio de Protocolo de datagramas de usuario (UDP) sin conexión. Se trata de una alternativa al uso de TCP/IP.
Sintaxis
WINLDAPAPI LDAP *LDAPAPI cldap_open(
[in] PSTR HostName,
[in] ULONG PortNumber
);
Parámetros
[in] HostName
Puntero a una cadena terminada en null que contiene una lista de nombres de host o cadenas de puntos que representan la dirección IP de los hosts del servidor LDAP. Use un solo espacio para separar los nombres de host de la lista. Cada nombre de host de la lista puede seguir un número de puerto. El número de puerto opcional se separa del propio host con dos puntos (:). El tiempo de ejecución LDAP intenta establecer la conexión con los hosts en el orden indicado, deteniendo cuando se realiza una conexión correcta.
[in] PortNumber
Número de puerto que se va a usar. Si no se especifica ningún número de puerto, el valor predeterminado es el puerto 389, que se define como LDAP_PORT. Si los números de puerto se incluyen en el parámetro HostName , este parámetro se omite.
Valor devuelto
Si la función se ejecuta correctamente, se devuelve un identificador de sesión en forma de puntero a una estructura LDAP. Libere el identificador de sesión con una llamada a ldap_unbind cuando ya no sea necesario.
Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener el código de error, llame a LdapGetLastError o a la función GetLastError de Win32.
Comentarios
La función cldap_open , a diferencia de ldap_open, crea un bloque de conexión para los servicios LDAP sin conexión basados en UDP. No se mantiene ninguna sesión TCP. Al igual que ldap_open, cldap_open asigna una estructura LDAP para mantener los datos de estado de la sesión e intenta realizar la conexión antes de volver al autor de la llamada. La llamada devuelve un identificador de sesión, que se pasa a las llamadas de función LDAP posteriores en el curso de la sesión. Cuando termine con la sesión, libere siempre el identificador de sesión asignado mediante ldap_unbind.
El uso de LDAP a través de UDP no admite el enlace y no admite TLS (SSL) ni SASL.
Multithreading: las llamadas a cldap_open 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 |