ldap_unbind_s-Funktion (winldap.h)
Die ldap_unbind_s-Funktion gibt Ressourcen, die einer LDAP-Sitzung zugeordnet sind, synchron frei.
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_unbind_s(
[in] LDAP *ld
);
Parameter
[in] ld
Das Sitzungshandle.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert LDAP_SUCCESS.
Wenn die Ausführung der Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Rückgabewerte.
Hinweise
Rufen Sie ldap_unbind_s auf, um die Bindung aus dem Verzeichnis zu entfernen, die Verbindung zu schließen und das Sitzungshandle zu entsorgen. Rufen Sie diese Funktion auf, wenn die LDAP-Verbindungsstruktur nicht mehr erforderlich ist, auch wenn Sie beim Öffnen der Verbindung nicht ldap_bind aufgerufen haben. Stellen Sie sicher, dass Sie diese Funktion nicht versehentlich mehr als einmal in einem Sitzungshandle aufrufen, da dadurch Ressourcen freigegeben werden können, die Sie nicht freigeben wollten.
Sowohl ldap_unbind als auch ldap_unbind_s arbeiten synchron. Es gibt keine Serverantwort auf einen nicht bindungslosen Vorgang.
Multithreading: Aufrufe an ldap_unbind_s sind sicher, mit der Ausnahme, dass Sie das Sitzungshandle nicht mehr für die LDAP-Struktur verwenden können, nachdem es freigegeben wurde.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | winldap.h |
| Bibliothek | Wldap32.lib |
| DLL | Wldap32.dll |