Structure LDAPControlA (winldap.h)
La structure LDAPControl représente à la fois les contrôles côté client et côté 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 large terminée par null qui indique le type de contrôle, par exemple « 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, définissez ce membre sur NULL.
ldctl_iscritical
Indique si le contrôle est critique, appelé champ Criticité.
Remarques
Avec LDAP 3, vous pouvez étendre les opérations LDAP à l’aide de contrôles. Les contrôles serveur peuvent être envoyés au serveur ou retournés au client avec n’importe quel message LDAP. Les contrôles clients étendent le comportement de l’API LDAP uniquement côté client et ne sont jamais envoyés au serveur. Un contrôle pris en charge est stocké en tant qu’identificateur d’objet (OID) à 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 zéro, le serveur et/ou le client ignorent le contrôle s’il n’est pas pris en charge et effectue 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 leurs descriptions, consultez Contrôles étendus.
Notes
L’en-tête winldap.h définit LDAPControl comme un 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. La combinaison 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| En-tête | winldap.h |