ldap_connect, fonction (winldap.h)
La fonction ldap_connect établit une connexion avec le serveur.
Syntaxe
WINLDAPAPI ULONG LDAPAPI ldap_connect(
[in] LDAP *ld,
[in] l_timeval *timeout
);
Paramètres
[in] ld
Handle de session obtenu à partir de ldap_init.
[in] timeout
Pointeur vers une structure de LDAP_TIMEVAL qui spécifie le nombre de secondes à passer dans une tentative d’établissement d’une connexion avant un délai d’expiration. Si la valeur est NULL, la fonction utilise une valeur de délai d’expiration par défaut.
Valeur retournée
Si la fonction réussit, LDAP_SUCCESS est retourné.
Si la fonction échoue, un code d’erreur est retourné. Pour plus d’informations, consultez Valeurs de retour.
Remarques
Bien qu’il ne soit pas nécessaire qu’un client appelle ldap_connect pour établir une connexion au serveur, il est recommandé de le faire. Si la connexion n’existe pas, d’autres fonctions, par exemple ldap_bind_s, effectuent l’appel en interne. Toutefois, si vous devez résoudre cette partie de votre application, l’établissement de la connexion avant d’appeler une autre fonction, par exemple ldap_bind_s, permet également de séparer les problèmes possibles en cas d’échec de la connexion. Vous pouvez également spécifier des options supplémentaires sur le bloc de connexion. Par exemple, un client peut appeler ldap_init pour initialiser une session, puis appeler ldap_connect, avec une valeur de paramètre de délai d’expiration non NULL , pour se connecter au serveur avec un délai d’attente spécifié.
Si l’appel à ldap_connect réussit, le client est connecté au serveur LDAP en tant qu’utilisateur anonyme. Le handle de session doit être libéré avec un appel à ldap_unbind lorsqu’il n’est plus nécessaire.
Si l’appel ldap_connect échoue, le handle de session doit être libéré avec un appel à ldap_unbind lorsqu’il n’est plus nécessaire pour la récupération d’erreur.
Configuration requise
| 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 |