funzione ldap_simple_bind_s (winldap.h)

Articolo
03/08/2023

La funzione ldap_simple_bind_s autentica in modo sincrono un client in un server usando una password in testo non crittografato.

Attenzione Questa funzione invia il nome e la password senza crittografarli e un utente non autorizzato, in rete, potrebbe leggere la password. A meno che non sia stata stabilita una sessione crittografata TLS (SSL), non eseguire questa funzione. Per altre informazioni su come configurare una sessione crittografata, vedere Inizializzazione di una sessione.

Sintassi

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

Parametri

[in] ld

Handle di sessione.

[in] dn

Nome dell'utente da associare come . L'operazione di associazione usa i parametri dn e passwd per autenticare l'utente.

[in] passwd

Password dell'utente specificato nel parametro dn .

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene LDAP_SUCCESS.

Se la funzione non viene completata, restituisce un codice di errore. Per altre informazioni, vedere Valori restituiti.

Commenti

La funzione ldap_simple_bind_s avvia una semplice operazione di associazione sincrona per autenticare un client in un server LDAP. Le chiamate di associazione successive possono essere usate per ripetere l'autenticazione usando la stessa connessione.

Al termine dell'operazione di associazione, ldap_simple_bind_s torna al chiamante. Utilizzare ldap_simple_bind se si preferisce eseguire l'operazione in modo asincrono. Tenere presente che se viene contattato un server LDAP 2, non tentare altre operazioni sulla connessione fino al completamento della chiamata di associazione.

Multithreading: le chiamate di associazione non sono sicure perché si applicano alla connessione nel suo complesso. Prestare attenzione se i thread condividono le connessioni e provano a eseguire l'associazione di thread con altre operazioni.

Nota Il client LDAP Microsoft usa un valore di timeout predefinito di 120 secondi (2 minuti) per ogni round trip di bind-response. Questo valore di timeout può essere modificato usando l'opzione di sessione LDAP_OPT_TIMELIMIT . Le altre operazioni non hanno un timeout a meno che non venga specificato utilizzando ldap_set_option.

Al termine di tutte le operazioni nell'handle di sessione, terminare la sessione passando l'handle di sessione LDAP alla funzione ldap_unbind . Inoltre, se la chiamata ldap_simple_bind_s 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