ldap_set_option, fonction (winldap.h)
La fonction ldap_set_option définit les options sur les blocs de connexion. Pour plus d’informations sur les structures, consultez Structures de données.
Syntaxe
WINLDAPAPI ULONG LDAPAPI ldap_set_option(
[in] LDAP *ld,
[in] int option,
[in] const void *invalue
);
Paramètres
[in] ld
Handle de session.
[in] option
Nom du jeu d’options.
[in] invalue
Pointeur vers la valeur que l’option doit être donnée. Le type réel de ce paramètre dépend du paramètre d’option. Les constantes LDAP_OPT_ON et LDAP_OPT_OFF peuvent être fournies pour les options qui ont des paramètres activés ou désactivés.
Valeur retournée
Si la fonction réussit, la valeur de retour est LDAP_SUCCESS.
Si la fonction échoue, elle retourne un code d'erreur. Pour plus d’informations, consultez Valeurs de retour.
Remarques
Appelez ldap_set_option pour accéder à la structure LDAP qui représente une session LDAP. N’essayez pas de modifier directement la structure de données LDAP.
Pour plus d’informations et une description des paramètres facultatifs qui s’appliquent à une session LDAP, consultez Options de session. Pour plus d’informations sur les indicateurs, consultez DsGetDcName.
Il est désormais possible de signer ou de chiffrer numériquement tout votre trafic LDAP à destination et en provenance d’un serveur LDAP Windows à l’aide du protocole d’authentification Kerberos. Cette nouvelle fonctionnalité assure l’intégrité et la confidentialité requises par certaines applications. N’oubliez pas que l’utilisation du protocole SSL (Secure Sockets Layer) vous offre les mêmes avantages, mais nécessite des inscriptions de certificats étendues pour le serveur et, parfois, pour le client.
Pour activer la signature et le scellement, vous devez activer l’une des options suivantes avant d’appeler ldap_bind_s avec LDAP_AUTH_NEGOTIATE pour la méthode bind.
#define LDAP_OPT_SIGN 0x95
#define LDAP_OPT_ENCRYPT 0x96
Pour désactiver la signature et le scellement, fermez la connexion en appelant ldap_unbind() sur le handle de connexion.
Multithreading : les appels à ldap_set_option sont non sécurisés, car ils affectent la connexion dans son ensemble. Soyez prudent si les threads partagent des connexions.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | winldap.h |
| Bibliothèque | Wldap32.lib |
| DLL | Wldap32.dll |