ADS_ESCAPE_MODE_ENUM énumération (iads.h)

Article
08/24/2023

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_DEFAULT
Valeur : 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.

Format du chemin d’accès récupéré	Mode d’échappement par défaut
ADS_FORMAT_X500	ADS_ESCAPEDMODE_ON
ADS_FORMAT_X500_NO_SERVER	ADS_ESCAPEDMODE_ON
ADS_FORMAT_WINDOWS	ADS_ESCAPEDMODE_ON
ADS_FORMAT_WINDOWS_NO_SERVER	ADS_ESCAPEDMODE_ON
ADS_FORMAT_X500_DN	ADS_ESCAPEDMODE_OFF
ADS_FORMAT_X500_PARENT	ADS_ESCAPEDMODE_OFF
ADS_FORMAT_WINDOWS_DN	ADS_ESCAPEDMODE_OFF
ADS_FORMAT_WINDOWS_PARENT	ADS_ESCAPEDMODE_OFF
ADS_FORMAT_LEAF	ADS_ESCAPEDMODE_ON

ADS_ESCAPEDMODE_ON
Valeur : 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_OFF
Valeur : 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_EX
Valeur : 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.

Note Étant donné que VBScript ne peut pas lire les données d’une bibliothèque de types, les applications Visual Basic Scripting Edition (VBScript) ne reconnaissent pas les symboles symboliques, comme les constantes définies ci-dessus. Utilisez plutôt les constantes numériques pour définir les indicateurs appropriés dans vos applications VBScript. Pour utiliser les constantes symboliques, écrivez des déclarations explicites de telles constantes, comme cela est fait ici.