fonction ldap_unbind (winldap.h)

Article
03/04/2024

La fonction ldap_unbind libère les ressources associées à une session LDAP.

Syntaxe

WINLDAPAPI ULONG LDAPAPI ldap_unbind(
  [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 pour dissocier à partir du répertoire, fermer la connexion et supprimer le handle de session. Appelez cette fonction lorsque vous avez terminé avec une structure de connexion LDAP , même si vous n’avez pas appelé ldap_bind lors de l’ouverture de la connexion. Assurez-vous que vous n’appelez pas cette fonction par inadvertance plusieurs fois sur un handle de session, car cela peut libérer des ressources que vous n’avez pas l’intention de libérer.

La fonction ldap_unbind concerne l’ensemble asynchrone d’API, mais elle se termine de manière synchrone. Il n’existe aucune réponse du serveur à une opération sans liaison.

Multithreading : les appels à ldap_unbind sont sécurisés, mais vous ne pouvez pas utiliser le handle de session vers la structure LDAP après sa libération.

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