ldap_unbind_s-Funktion (winldap.h)

Artikel
08/27/2023

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