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

Voir aussi

Structures de données

LDAPMessage

Utilisation de contrôles