enumerazione ADS_ESCAPE_MODE_ENUM (iads.h)

L'enumerazione ADS_ESCAPE_MODE_ENUM specifica la modalità di visualizzazione dei caratteri di escape in un percorso di directory.

Sintassi

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;

Costanti

ADS_ESCAPEDMODE_DEFAULT Valore: 1 La modalità di escape predefinita offre un'opzione pratica per specificare la modalità di escape. Ha l'effetto di un'operazione di escape minima appropriata per un formato scelto. Di conseguenza, il comportamento predefinito dipende dal valore usato ADS_FORMAT_ENUM per recuperare i percorsi della directory. Formato percorso recuperato Modalità di escape predefinita 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 Valore: 2 Tutti i caratteri speciali vengono visualizzati nel formato di escape; Ad esempio, "CN=date=yy/mm/dd,weekday" viene visualizzato così com'è.
ADS_ESCAPEDMODE_OFF Valore: 3 I caratteri speciali ADSI vengono visualizzati nel formato senza caratteri di escape; Ad esempio, "CN=date=yy/mm/dd,weekday" viene visualizzato come "CN=date=yy/mm/dd,weekday".
ADS_ESCAPEDMODE_OFF_EX Valore: 4 I caratteri speciali ADSI e LDAP vengono visualizzati nel formato senza caratteri di escape; Ad esempio, "CN=date=yy/mm/dd,weekday" viene visualizzato come "CN=date=yy/mm/dd,weekday".

Commenti

I caratteri speciali devono essere preceduti da un carattere di escape quando vengono utilizzati per scopi imprevisti. Ad esempio, i caratteri speciali LDAP, la virgola (,) e il segno di uguale (=), sono destinati come separatori di campo in un nome distinto, "CN=utente,CN=users,DC=Fabrikam,DC=com". Quando un valore di attributo usa tali caratteri speciali, ad esempio "CN=users,last name=Smith", questi caratteri speciali devono essere preceduti da caratteri di escape, come illustrato. In questo modo si garantisce che una directory conforme a LDAP, ad esempio Active Directory, analizzi correttamente il percorso. Tuttavia, una stringa di percorso preceduta da escape potrebbe non sembrare intuitiva in una visualizzazione. In questo caso, è possibile impostare il ADS_ESCAPE_MODE_ENUM in modo che mostri il percorso come stringa senza caratteri di escape, "CN=users,cognome=Smith".

Analogamente, il carattere speciale ADSI, la barra (/), separa gli elementi specifici di ADSI, "LDAP://server/CN=Jeff Smith,CN=Users,DC=Fabrikam,DC=com". Anche se deve essere preceduto da un escape per qualsiasi altro scopo, ad esempio "LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com". È possibile scegliere un'opzione di ADS_ESCAPE_MODE_ENUM per visualizzare questa stringa di escape in un formato leggibile: "LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com".

Attualmente, la barra (/) è l'unico carattere speciale ADSI. L'escape ADSI e l'annullamento dell'incapsulamento si applica solo ai caratteri speciali ADSI. L'operazione non influirà su caratteri speciali LDAP, ovvero non sono preceduti da caratteri di escape né senza caratteri di escape. Per altre informazioni e un elenco di caratteri speciali definiti da LDAP, vedere Ldap Special Characters.For more information and a list of special characters defined by LDAP, see LDAP Special Characters.

Per visualizzare la stringa di percorso senza caratteri di escape, usare l'interfaccia IADsPathname e i relativi metodi. Tutte le altre API ADSI restituiscono la stringa di percorso preceduta da escape.

Per ottenere un comportamento corretto, i caratteri speciali LDAP devono essere preceduti da un carattere di escape prima dell'escape dei caratteri speciali ADSI. L'interfaccia IADsPathname eseguirà l'escape dei caratteri nella sequenza corretta.

Nota Poiché VBScript non è in grado di leggere i dati da una libreria dei tipi, le applicazioni Visual Basic Scripting Edition (VBScript) non riconoscono il simbolo, come costanti definite in precedenza. Usare invece le costanti numeriche per impostare i flag appropriati nelle applicazioni VBScript. Per usare le costanti simboliche, scrivere dichiarazioni esplicite di tali costanti, come fatto qui.

 

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	iads.h

Vedi anche

Enumerazioni ADSI

ADS_FORMAT_ENUM

IADsPathname

LDAP ADsPath