funzione cldap_open (winldap.h)

Articolo
03/08/2023

La funzione cldap_open stabilisce una sessione con un server LDAP tramite un servizio UDP (User Datagram Protocol) senza connessione. Si tratta di un'alternativa all'uso di TCP/IP.

Sintassi

WINLDAPAPI LDAP *LDAPAPI cldap_open(
  [in] PSTR  HostName,
  [in] ULONG PortNumber
);

Parametri

[in] HostName

Puntatore a una stringa con terminazione Null che contiene un elenco di nomi host o stringhe punteggiate che rappresentano l'indirizzo IP degli host del server LDAP. Usare uno spazio singolo per separare i nomi host nell'elenco. Ogni nome host nell'elenco può essere seguito da un numero di porta. Il numero di porta facoltativo è separato dall'host stesso con due punti (:). Il runtime LDAP tenta di connettersi con gli host nell'ordine elencato, arrestandosi quando viene stabilita una connessione riuscita.

[in] PortNumber

Numero di porta da utilizzare. Se non viene specificato alcun numero di porta, il valore predefinito è la porta 389, definita come LDAP_PORT. Se i numeri di porta sono inclusi nel parametro HostName , questo parametro viene ignorato.

Valore restituito

Se la funzione ha esito positivo, viene restituito un handle di sessione sotto forma di puntatore a una struttura LDAP. Liberare l'handle di sessione con una chiamata a ldap_unbind quando non è più necessario.

Se la funzione ha esito negativo, il valore restituito è NULL. Per ottenere il codice di errore, chiamare LdapGetLastError o la funzione Win32 GetLastError.

Commenti

La funzione cldap_open , a differenza di ldap_open, crea un blocco di connessione per i servizi LDAP senza connessione basati su UDP. Non viene mantenuta alcuna sessione TCP. Come ldap_open, cldap_open alloca una struttura LDAP per mantenere i dati sullo stato per la sessione e quindi tenta di stabilire la connessione prima di tornare al chiamante. La chiamata restituisce un handle di sessione, che viene passato alle successive chiamate di funzione LDAP nel corso della sessione. Al termine della sessione, liberare sempre l'handle di sessione allocato usando ldap_unbind.

L'uso di LDAP su UDP non supporta l'associazione e non supporta TLS (SSL) o SASL.

Multithreading: le chiamate a cldap_open sono thread-safe.

Nota Quando si usa cldap_open, la connessione viene aperta da un utente anonimo. Le uniche operazioni disponibili sono quelle che un utente anonimo può eseguire.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	winldap.h
Libreria	Wldap32.lib
DLL	Wldap32.dll

Vedi anche

Condividi tramite