ldap_unbind-Funktion (winldap.h)

Artikel
03/04/2024

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

Siehe auch