ldap_unbind-Funktion (winldap.h)
Die ldap_unbind-Funktion gibt Ressourcen frei, die einer LDAP-Sitzung zugeordnet sind.
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_unbind(
[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 auf, um die Bindung aus dem Verzeichnis zu entfernen, schließen Sie die Verbindung, und entfernen Sie das Sitzungshandle. Rufen Sie diese Funktion auf, wenn Sie mit einer LDAP-Verbindungsstruktur fertig sind, 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.
Die ldap_unbind-Funktion ist für den asynchronen Satz von APIs bestimmt, wird jedoch synchron abgeschlossen. Es gibt keine Serverantwort auf einen nicht bindungslosen Vorgang.
Multithreading: Aufrufe an ldap_unbind sind sicher, aber Sie können das Sitzungshandle nicht für die LDAP-Struktur verwenden, nachdem es freigegeben wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | winldap.h |
| Bibliothek | Wldap32.lib |
| DLL | Wldap32.dll |