função ldap_simple_bind_s (winldap.h)

Artigo
08/27/2023

A função ldap_simple_bind_s autentica de forma síncrona um cliente em um servidor, usando uma senha de texto não criptografado.

Cuidado Essa função envia o nome e a senha sem criptografá-los, e um usuário não autorizado, na rede, pode ler a senha. A menos que uma sessão criptografada TLS (SSL) tenha sido estabelecida, não faça essa função. Para obter mais informações sobre como configurar uma sessão criptografada, consulte Inicializando uma sessão.

Sintaxe

WINLDAPAPI ULONG LDAPAPI ldap_simple_bind_s(
  [in] LDAP       *ld,
  [in] const PSTR dn,
  [in] const PSTR passwd
);

Parâmetros

[in] ld

O identificador de sessão.

[in] dn

O nome do usuário como o qual associar. A operação de associação usa os parâmetros dn e passwd para autenticar o usuário.

[in] passwd

A senha do usuário especificada no parâmetro dn .

Valor retornado

Se a função for bem-sucedida, o valor retornado será LDAP_SUCCESS.

Se a função falhar, será exibido um código de erro. Para obter mais informações, consulte Valores retornados.

Comentários

A função ldap_simple_bind_s inicia uma operação de associação síncrona simples para autenticar um cliente em um servidor LDAP. Chamadas de associação subsequentes podem ser usadas para autenticar novamente usando a mesma conexão.

Após a conclusão da operação de associação, ldap_simple_bind_s retorna ao chamador. Use ldap_simple_bind se preferir que a operação seja executada de forma assíncrona. Lembre-se de que, se um servidor LDAP 2 for contatado, não tente outras operações pela conexão até que a chamada de associação seja concluída com êxito.

Multithreading: as chamadas de associação não são seguras porque se aplicam à conexão como um todo. Tenha cuidado se os threads compartilharem conexões e tentarem associar threads a outras operações.

Nota O cliente LDAP da Microsoft usa um valor de tempo limite padrão de 120 segundos (2 minutos) para cada viagem de ida e volta de resposta de associação. Esse valor de tempo limite pode ser alterado usando a opção de sessão LDAP_OPT_TIMELIMIT . Outras operações não têm um tempo limite, a menos que especificado usando ldap_set_option.

Quando todas as operações no identificador de sessão forem concluídas, encerre a sessão passando o identificador de sessão LDAP para a função ldap_unbind . Além disso, se a chamada ldap_simple_bind_s 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