Structure LDAPControlA (winldap.h)
La structure LDAPControl représente à la fois les contrôles côté client et serveur.
Syntaxe
typedef struct ldapcontrolA {
PCHAR ldctl_oid;
struct berval ldctl_value;
BOOLEAN ldctl_iscritical;
} LDAPControlA, *PLDAPControlA;
Membres
ldctl_oid
Pointeur vers une chaîne étendue terminée par null qui indique le type de contrôle, tel que « 1.2.840.113556.1.4.805 ».
ldctl_value
Données associées au contrôle, le cas échéant. Si aucune donnée n’est associée au contrôle, affectez à ce membre la valeur NULL.
ldctl_iscritical
Indique si le contrôle est critique, appelé champ Criticality.
Remarques
À compter du protocole LDAP 3, vous pouvez étendre les opérations LDAP via l’utilisation de contrôles. Les contrôles serveur peuvent être envoyés au serveur ou renvoyés au client avec n’importe quel message LDAP. Les contrôles clients étendent le comportement de l’API LDAP côté client uniquement et ne sont jamais envoyés au serveur. Un contrôle pris en charge est stocké en tant qu’identificateur d’objet (OID) dans la racine du service d’annuaire.
Le membre ldctl_iscritical permet à une opération étendue de réussir lorsque le serveur ou le client ne prend pas en charge le contrôle. Si la valeur de ce champ est égale à zéro, le serveur et/ou le client ignorent le contrôle s’il n’est pas pris en charge et exécute l’opération. Si la valeur est différente de zéro, l’opération est effectuée uniquement si le contrôle est reconnu par le serveur et/ou le client.
Pour plus d’informations et une liste des contrôles étendus LDAP pris en charge et de leurs descriptions, consultez contrôles étendus.
Note
L’en-tête winldap.h définit LDAPControl comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| serveur minimum pris en charge | Windows Server 2008 |
| d’en-tête | winldap.h |