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

Voir aussi

DsGetDcName

Fonctions

Obtention et définition des options de session

LDAP

Valeurs retournées

ldap_get_option