fonction cldap_open (winldap.h)

Article
03/04/2024

La fonction cldap_open établit une session avec un serveur LDAP via un service UDP (User Datagram Protocol) sans connexion. Il s’agit d’une alternative à l’utilisation de TCP/IP.

Syntaxe

WINLDAPAPI LDAP *LDAPAPI cldap_open(
  [in] PSTR  HostName,
  [in] ULONG PortNumber
);

Paramètres

[in] HostName

Pointeur vers une chaîne terminée par null qui contient une liste de noms d’hôtes ou de chaînes en pointillés qui représentent l’adresse IP des hôtes de serveur LDAP. Utilisez un espace unique pour séparer les noms d’hôtes de la liste. Chaque nom d’hôte de la liste peut être suivi d’un numéro de port. Le numéro de port facultatif est séparé de l’hôte lui-même par un signe deux-points (:). Le temps d’exécution LDAP tente la connexion avec les hôtes dans l’ordre indiqué, s’arrêtant lorsqu’une connexion réussie est établie.

[in] PortNumber

Numéro de port à utiliser. Si aucun numéro de port n’est spécifié, la valeur par défaut est le port 389, qui est défini comme LDAP_PORT. Si les numéros de port sont inclus dans le paramètre HostName , ce paramètre est ignoré.

Valeur retournée

Si la fonction réussit, un handle de session, sous la forme d’un pointeur vers une structure LDAP, est retourné. Libérez le handle de session avec un appel à ldap_unbind lorsqu’il n’est plus nécessaire.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir le code d’erreur, appelez LdapGetLastError ou la fonction Win32 GetLastError.

Remarques

Contrairement àldap_open, la fonction cldap_open crée un bloc de connexion pour les services LDAP sans connexion udp. Aucune session TCP n’est conservée. Comme ldap_open, cldap_open alloue une structure LDAP pour gérer les données d’état de la session, puis tente d’effectuer la connexion avant de revenir à l’appelant. L’appel retourne un handle de session que vous passez aux appels de fonction LDAP suivants au cours de la session. Une fois la session terminée, libérez toujours le handle de session alloué à l’aide de ldap_unbind.

L’utilisation de LDAP sur UDP ne prend pas en charge la liaison et ne prend pas en charge TLS (SSL) ou SASL.

Multithreading : les appels à cldap_open sont thread-safe.

Note Lorsque vous utilisez cldap_open, la connexion est ouverte par un utilisateur anonyme. Les seules opérations disponibles sont celles qu’un utilisateur anonyme peut exécuter.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	winldap.h
Bibliothèque	Wldap32.lib
DLL	Wldap32.dll

Voir aussi

Fonctions

Obtenir la dernière erreur

LdapGetLastError

ldap_open

ldap_unbind

Partager via