Funzione ldap_connect (winldap.h)
La funzione ldap_connect stabilisce una connessione con il server.
Sintassi
WINLDAPAPI ULONG LDAPAPI ldap_connect(
[in] LDAP *ld,
[in] l_timeval *timeout
);
Parametri
[in] ld
Handle di sessione ottenuto da ldap_init.
[in] timeout
Puntatore a una struttura LDAP_TIMEVAL che specifica il numero di secondi da dedicare a un tentativo di stabilire una connessione prima di un timeout. Se NULL, la funzione usa un valore di timeout predefinito.
Valore restituito
Se la funzione ha esito positivo, viene restituito LDAP_SUCCESS .
Se la funzione ha esito negativo, viene restituito un codice di errore. Per altre informazioni, vedere Valori restituiti.
Commenti
Anche se non è necessario che una chiamata client ldap_connect per stabilire una connessione al server, è consigliabile eseguire questa operazione nella programmazione. Se la connessione non esiste, altre funzioni, ad esempio ldap_bind_s, eseguono la chiamata internamente. Tuttavia, se è necessario risolvere questa parte dell'applicazione, stabilire la connessione prima di effettuare la chiamata a un'altra funzione, ad esempio ldap_bind_s, separa anche i possibili problemi se la connessione non riesce. In alternativa, è possibile specificare opzioni aggiuntive nel blocco di connessione. Ad esempio, un client può chiamare ldap_init per inizializzare una sessione, quindi chiamare ldap_connect, con un valore di parametro di timeout non NULL , per connettersi al server con un timeout specificato.
Se la chiamata a ldap_connect ha esito positivo, il client viene connesso al server LDAP come utente anonimo. L'handle di sessione deve essere liberato con una chiamata a ldap_unbind quando non è più necessario.
Se la chiamata ldap_connect ha esito negativo, l'handle di sessione deve essere liberato con una chiamata a ldap_unbind quando non è più necessario per il ripristino degli errori.
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | winldap.h |
| Libreria | Wldap32.lib |
| DLL | Wldap32.dll |