ldap_unbind_s, fonction (winldap.h)

Article
08/27/2023

La fonction ldap_unbind_s libère de façon synchrone les ressources associées à une session LDAP.

Syntaxe

WINLDAPAPI ULONG LDAPAPI ldap_unbind_s(
  [in] LDAP *ld
);

Paramètres

[in] ld

Handle de session.

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

Appelez ldap_unbind_s pour dissocier du répertoire, fermer la connexion et supprimer le handle de session. Appelez cette fonction lorsque la structure de connexion LDAP n’est plus nécessaire, même si vous n’avez pas appelé ldap_bind lors de l’ouverture de la connexion. Veillez à ne pas appeler cette fonction par inadvertance plusieurs fois sur un handle de session, car cela peut libérer des ressources que vous n’aviez pas l’intention de libérer.

Les ldap_unbind et les ldap_unbind_s fonctionnent de manière synchrone. Il n’existe aucune réponse du serveur à une opération de dissociage.

Multithreading : les appels à ldap_unbind_s sont sécurisés, sauf que vous ne pouvez pas utiliser le handle de session pour la structure LDAP une fois qu’elle a été libérée.

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