cldap_open-Funktion (winldap.h)
Die cldap_open-Funktion richtet eine Sitzung mit einem LDAP-Server über einen verbindungslosen UDP-Dienst (User Datagram Protocol) ein. Dies ist eine Alternative zur Verwendung von TCP/IP.
Syntax
WINLDAPAPI LDAP *LDAPAPI cldap_open(
[in] PSTR HostName,
[in] ULONG PortNumber
);
Parameter
[in] HostName
Ein Zeiger auf eine NULL-Zeichenfolge, die eine Liste von Hostnamen oder gepunkteten Zeichenfolgen enthält, die die IP-Adresse von LDAP-Serverhosts darstellen. Verwenden Sie einen einzelnen Leerraum, um die Hostnamen in der Liste zu trennen. Jedem Hostnamen in der Liste kann eine Portnummer folgen. Die optionale Portnummer wird durch einen Doppelpunkt (:)) vom Host selbst getrennt. Die LDAP-Laufzeit versucht, eine Verbindung mit den Hosts in der aufgeführten Reihenfolge herzustellen, und wird beendet, wenn eine erfolgreiche Verbindung hergestellt wird.
[in] PortNumber
Die zu verwendende Portnummer. Wenn keine Portnummer angegeben ist, ist der Standardwert Port 389, der als LDAP_PORT definiert ist. Wenn portnummern im HostName-Parameter enthalten sind, wird dieser Parameter ignoriert.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ein Sitzungshandle in Form eines Zeigers auf eine LDAP-Struktur zurückgegeben. Geben Sie das Sitzungshandle mit einem Aufruf an ldap_unbind frei, wenn es nicht mehr benötigt wird.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um den Fehlercode abzurufen, rufen Sie LdapGetLastError oder die Win32-Funktion GetLastError auf.
Hinweise
Die cldap_open-Funktion erstellt im Gegensatz zu ldap_open einen Verbindungsblock für UDP-basierte verbindungslose LDAP-Dienste. Es wird keine TCP-Sitzung beibehalten. Wie ldap_open weist cldap_open eine LDAP-Struktur zu, um Zustandsdaten für die Sitzung zu verwalten, und versucht dann, die Verbindung herzustellen, bevor sie zum Aufrufer zurückkehrt. Der Aufruf gibt ein Sitzungshandle zurück, das Sie im Verlauf der Sitzung an nachfolgende LDAP-Funktionsaufrufe übergeben. Wenn Sie mit der Sitzung fertig sind, geben Sie immer das zugeordnete Sitzungshandle mithilfe von ldap_unbind frei.
Die Verwendung von LDAP über UDP unterstützt keine Bindung und nicht TLS (SSL) oder SASL.
Multithreading: Aufrufe an cldap_open sind threadsicher.
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 |