ldap_unbind_s, fonction (winldap.h)
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 |