função ldap_simple_bind (winldap.h)

Artigo
03/04/2024

O ldap_simple_bind autentica de forma assíncrona um cliente em um servidor usando uma senha de texto sem formatação.

Cuidado Essa função envia o nome e a senha sem criptografá-los e, portanto, alguém escutando na rede pode ler a senha. A menos que uma sessão criptografada TLS (SSL) tenha sido estabelecida, não use 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(
  [in] LDAP       *ld,
  [in] const PSTR dn,
  [in] const PSTR passwd
);

Parâmetros

[in] ld

O identificador da sessão.

[in] dn

O nome do usuário como associado. 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 .

Retornar valor

Se a função for bem-sucedida, ela retornará a ID da mensagem da operação iniciada.

Se a função falhar, ela retornará -1 e definirá os parâmetros de erro de sessão na estrutura de dados LDAP.

Comentários

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

Para se autenticar como um usuário específico, forneça o nome da entrada (usuário) e a senha dessa entrada. Para autenticar um usuário anônimo, quando nenhuma permissão de acesso for necessária, passe NULL para os parâmetros dn e passwd .

Como uma função assíncrona, ldap_simple_bind retorna uma ID de mensagem para a operação. Chame ldap_result com a ID da mensagem para obter o resultado da operação. Para cancelar uma operação de associação assíncrona antes de ser concluída, chame ldap_abandon. 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.

Para retornar os resultados diretamente, use a rotina síncrona ldap_simple_bind_s.

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 com outras operações.

Nota O cliente LDAP da Microsoft usa um valor de tempo limite padrão de 120 segundos (2 minutos) para cada 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 seja 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 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 erro.

A função ldap_simple_bind foi projetada para associar ao domínio local. A função não pode ser usada para autenticação entre florestas.

Requisitos

Requisito	Valor
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