ADS_ESCAPE_MODE_ENUM énumération (iads.h)
L’énumération ADS_ESCAPE_MODE_ENUM spécifie la façon dont les caractères d’échappement sont affichés dans un chemin d’accès de répertoire.
Syntax
typedef enum __MIDL___MIDL_itf_ads_0001_0078_0004 {
ADS_ESCAPEDMODE_DEFAULT = 1,
ADS_ESCAPEDMODE_ON = 2,
ADS_ESCAPEDMODE_OFF = 3,
ADS_ESCAPEDMODE_OFF_EX = 4
} ADS_ESCAPE_MODE_ENUM;
Constantes
ADS_ESCAPEDMODE_DEFAULTValeur : 1 Le mode d’échappement par défaut fournit une option pratique pour spécifier le mode d’échappement. Il a l’effet d’une opération d’échappement minimale appropriée pour un format choisi. Par conséquent, le comportement par défaut dépend de la valeur que ADS_FORMAT_ENUM utilise pour récupérer les chemins d’accès au répertoire.
|
||||||||||||||||||||
ADS_ESCAPEDMODE_ONValeur : 2 Tous les caractères spéciaux sont affichés dans le format d’échappement ; par exemple, « CN=date=yy/mm/jj,jour de la semaine » s’affiche tel qu’il est. |
||||||||||||||||||||
ADS_ESCAPEDMODE_OFFValeur : 3 Les caractères spéciaux ADSI sont affichés au format non échiffé ; par exemple, « CN=date=yy/mm/jj,jour de la semaine » s’affiche sous la forme « CN=date=yy/mm/jj,jour de la semaine ». |
||||||||||||||||||||
ADS_ESCAPEDMODE_OFF_EXValeur : 4 Les caractères spéciaux ADSI et LDAP sont affichés au format non échiffé ; par exemple, « CN=date=yy/mm/jj,jour de la semaine » s’affiche sous la forme « CN=date=yy/mm/jj,jour de la semaine ». |
Remarques
Les caractères spéciaux doivent être placés dans une séquence d’échappement lorsqu’ils sont utilisés à des fins inattendues. Par exemple, les caractères spéciaux LDAP, la virgule (,) et le signe égal (=), sont destinés à être des séparateurs de champs dans un nom unique, « CN=user,CN=users,DC=Fabrikam,DC=com ». Lorsqu’une valeur d’attribut utilise ces caractères spéciaux, par exemple« CN=users,last name=Smith », ces caractères spéciaux doivent être placés dans une séquence d’échappement comme indiqué. Cela garantit qu’un répertoire compatible LDAP, tel qu’Active Directory, analyse correctement le chemin d’accès. Toutefois, une chaîne de chemin d’échappement peut ne pas sembler conviviale sur un écran. Dans ce cas, vous pouvez définir le ADS_ESCAPE_MODE_ENUM de manière à afficher le chemin d’accès sous la forme d’une chaîne non échiffée, « CN=users,last name=Smith ».
De même, le caractère spécial ADSI, la barre oblique (/), sépare les éléments spécifiques à ADSI, « LDAP://server/CN=Jeff Smith,CN=Users,DC=Fabrikam,DC=com ». Bien qu’il doit être placé dans une séquence d’échappement lorsqu’il est utilisé à d’autres fins, par exemple, « LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com ». Vous pouvez choisir une option ADS_ESCAPE_MODE_ENUM pour afficher cette chaîne d’échappement sous une forme lisible par l’homme : « LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com ».
Actuellement, la barre oblique (/) est le seul caractère spécial ADSI. L’échappement adsi et le déscapsulation s’appliquent uniquement aux caractères spéciaux ADSI. L’opération n’affectera aucun caractère spécial LDAP, c’est-à-dire qu’ils ne sont ni échappés ni non échappés. Pour plus d’informations et une liste de caractères spéciaux définis par LDAP, consultez Caractères spéciaux LDAP.
Pour afficher la chaîne de chemin d’accès non masquée, utilisez l’interface IADsPathname et ses méthodes. Toutes les autres API ADSI retournent la chaîne de chemin d’échappement.
Pour obtenir un comportement correct, les caractères spéciaux LDAP doivent être placés dans une séquence d’échappement avant que les caractères spéciaux ADSI soient placés dans une séquence d’échappement. L’interface IADsPathname permet d’échapper les caractères dans la séquence correcte.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| En-tête | iads.h |