ldap_connect-Funktion (winldap.h)
Die funktion ldap_connect stellt eine Verbindung mit dem Server her.
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_connect(
[in] LDAP *ld,
[in] l_timeval *timeout
);
Parameter
[in] ld
Das von ldap_init abgerufene Sitzungshandle.
[in] timeout
Ein Zeiger auf eine LDAP_TIMEVAL Struktur, die die Anzahl von Sekunden angibt, die für den Versuch, eine Verbindung herzustellen, vor einem Timeout aufwendet werden soll. Wenn NULL, verwendet die Funktion einen Standardtimeoutwert.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird LDAP_SUCCESS zurückgegeben.
Wenn die Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Rückgabewerte.
Hinweise
Obwohl es nicht erforderlich ist, dass ein Clientaufruf ldap_connect , um eine Verbindung mit dem Server herzustellen, empfiehlt es sich, dies zu tun. Wenn die Verbindung nicht vorhanden ist, führen andere Funktionen, z. B. ldap_bind_s, den Aufruf intern aus. Wenn Sie jedoch diesen Teil Ihrer Anwendung behandeln müssen, trennt das Herstellen der Verbindung vor dem Aufruf einer anderen Funktion, z . B. ldap_bind_s, auch die möglichen Probleme, wenn die Verbindung fehlschlägt. Alternativ können Sie zusätzliche Optionen für den Verbindungsblock angeben. Beispielsweise kann ein Client ldap_init aufrufen, um eine Sitzung zu initialisieren, und dann ldap_connect mit einem Timeoutparameterwert ungleich NULL aufrufen, um eine Verbindung mit dem Server mit einem angegebenen Timeout herzustellen.
Wenn der Aufruf von ldap_connect erfolgreich ist, wird der Client als anonymer Benutzer mit dem LDAP-Server verbunden. Das Sitzungshandle sollte mit einem Aufruf von ldap_unbind freigegeben werden, wenn es nicht mehr benötigt wird.
Wenn der ldap_connect Aufruf fehlschlägt, sollte das Sitzungshandle mit einem Aufruf von ldap_unbind freigegeben werden, wenn die Fehlerwiederherstellung nicht mehr erforderlich ist.
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 |