Função ldap_connect (winldap.h)
A função ldap_connect estabelece uma conexão com o servidor.
Sintaxe
WINLDAPAPI ULONG LDAPAPI ldap_connect(
[in] LDAP *ld,
[in] l_timeval *timeout
);
Parâmetros
[in] ld
O identificador de sessão obtido de ldap_init.
[in] timeout
Um ponteiro para uma estrutura LDAP_TIMEVAL que especifica o número de segundos a serem gastos em uma tentativa de estabelecer uma conexão antes de um tempo limite. Se FOR NULL, a função usará um valor de tempo limite padrão.
Valor retornado
Se a função for bem-sucedida, LDAP_SUCCESS será retornado.
Se a função falhar, um código de erro será retornado. Para obter mais informações, consulte Valores retornados.
Comentários
Embora não seja necessário que uma chamada de cliente ldap_connect estabelecer uma conexão com o servidor, é uma boa prática de programação fazer isso. Se a conexão não existir, outras funções, por exemplo, ldap_bind_s, executarão a chamada internamente. No entanto, se você precisar solucionar problemas dessa parte do aplicativo, estabelecer a conexão antes de fazer a chamada para alguma outra função, por exemplo , ldap_bind_s, também separará os possíveis problemas se a conexão falhar. Como alternativa, você pode especificar opções adicionais no bloco de conexão. Por exemplo, um cliente pode chamar ldap_init para inicializar uma sessão e, em seguida, chamar ldap_connect, com um valor de parâmetro de tempo limite não NULL , para se conectar ao servidor com um tempo limite especificado.
Se a chamada para ldap_connect for bem-sucedida, o cliente será conectado ao servidor LDAP como um usuário anônimo. O identificador de sessão deve ser liberado com uma chamada para ldap_unbind quando não for mais necessário.
Se a chamada ldap_connect falhar, o identificador de sessão deverá ser liberado com uma chamada para ldap_unbind quando não for mais necessário para a recuperação de erros.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | winldap.h |
| Biblioteca | Wldap32.lib |
| DLL | Wldap32.dll |