ldap_simple_bind_s, fonction (winldap.h)

Article
08/27/2023

La fonction ldap_simple_bind_s authentifie de façon synchrone un client auprès d’un serveur, à l’aide d’un mot de passe en texte clair.

Attention Cette fonction envoie le nom et le mot de passe sans les chiffrer, et un utilisateur non autorisé, sur le réseau, peut lire le mot de passe. À moins qu’une session chiffrée TLS (SSL) ait été établie, n’utilisez pas cette fonction. Pour plus d’informations sur la configuration d’une session chiffrée, consultez Initialisation d’une session.

Syntaxe

WINLDAPAPI ULONG LDAPAPI ldap_simple_bind_s(
  [in] LDAP       *ld,
  [in] const PSTR dn,
  [in] const PSTR passwd
);

Paramètres

[in] ld

Handle de session.

[in] dn

Nom de l’utilisateur à lier. L’opération de liaison utilise les paramètres dn et passwd pour authentifier l’utilisateur.

[in] passwd

Mot de passe de l’utilisateur spécifié dans le paramètre dn .

Valeur retournée

Si la fonction réussit, la valeur de retour est LDAP_SUCCESS.

Si la fonction échoue, elle retourne un code d'erreur. Pour plus d’informations, consultez Valeurs de retour.

Remarques

La fonction ldap_simple_bind_s lance une opération de liaison synchrone simple pour authentifier un client auprès d’un serveur LDAP. Les appels de liaison suivants peuvent être utilisés pour se réauthentifier à l’aide de la même connexion.

Une fois l’opération de liaison terminée, ldap_simple_bind_s retourne à l’appelant. Utilisez ldap_simple_bind si vous préférez effectuer l’opération de manière asynchrone. N’oubliez pas que si un serveur LDAP 2 est contacté, ne tentez pas d’autres opérations sur la connexion tant que l’appel de liaison n’est pas terminé.

Multithreading : les appels de liaison sont dangereux, car ils s’appliquent à la connexion dans son ensemble. Soyez prudent si les threads partagent des connexions et essaient de lier des threads avec d’autres opérations.

Note Le client LDAP Microsoft utilise une valeur de délai d’expiration par défaut de 120 secondes (2 minutes) pour chaque aller-retour liaison-réponse. Cette valeur de délai d’expiration peut être modifiée à l’aide de l’option LDAP_OPT_TIMELIMIT session. Les autres opérations n’ont pas de délai d’expiration, sauf si elles sont spécifiées à l’aide de ldap_set_option.

Lorsque toutes les opérations sur le handle de session sont terminées, terminez la session en passant le handle de session LDAP à la fonction ldap_unbind . En outre, si l’appel ldap_simple_bind_s é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