funzione ldap_set_option (winldap.h)
La funzione ldap_set_option imposta le opzioni sui blocchi di connessione. Per altre informazioni sulle strutture, vedere Strutture dati.
Sintassi
WINLDAPAPI ULONG LDAPAPI ldap_set_option(
[in] LDAP *ld,
[in] int option,
[in] const void *invalue
);
Parametri
[in] ld
Handle di sessione.
[in] option
Nome del set di opzioni.
[in] invalue
Puntatore al valore da specificare per l'opzione. Il tipo effettivo di questo parametro dipende dall'impostazione del parametro di opzione. Le costanti LDAP_OPT_ON e LDAP_OPT_OFF possono essere fornite per le opzioni che dispongono di impostazioni su o disattivate.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è LDAP_SUCCESS.
Se la funzione non viene completata, restituisce un codice di errore. Per altre informazioni, vedere Valori restituiti.
Commenti
Chiamare ldap_set_option per accedere alla struttura LDAP che rappresenta una sessione LDAP . Non tentare di modificare direttamente la struttura di dati LDAP.
Per altre informazioni e una descrizione delle impostazioni facoltative che si applicano a una sessione LDAP, vedere Opzioni sessione. Per altre informazioni sui flag, vedere DsGetDcName.
È ora possibile firmare o crittografare digitalmente tutto il traffico LDAP verso e da un server LDAP di Windows usando il protocollo di autenticazione Kerberos. Questa nuova funzionalità offre integrità e riservatezza richieste da alcune applicazioni. Tenere presente che l'uso di Secure Sockets Layer (SSL) offre gli stessi vantaggi, ma richiede registrazioni di certificati estese per il server e, a volte, per il client.
Per abilitare la firma e la chiusura, è necessario attivare una delle opzioni seguenti prima di chiamare ldap_bind_s con LDAP_AUTH_NEGOTIATE per il metodo di associazione.
#define LDAP_OPT_SIGN 0x95
#define LDAP_OPT_ENCRYPT 0x96
Per disattivare la firma e la chiusura, chiudere la connessione chiamando ldap_unbind() nell'handle di connessione.
Multithreading: le chiamate a ldap_set_option non sono sicure perché influiscono sulla connessione nel suo complesso. Prestare attenzione se i thread condividono le connessioni.
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 |