ADS_ESCAPE_MODE_ENUM enumeração (iads.h)

A enumeração ADS_ESCAPE_MODE_ENUM especifica como os caracteres de escape são exibidos em um caminho de diretório.

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 Valor: 1 O modo de escape padrão fornece uma opção conveniente para especificar o modo de escape. Ele tem o efeito da operação de escape mínima apropriada para um formato escolhido. Portanto, o comportamento padrão depende do valor que ADS_FORMAT_ENUM usa para recuperar os caminhos de diretório. Formato de caminho recuperado Modo de escape padrão 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 Valor: 2 Todos os caracteres especiais são exibidos no formato de escape; por exemplo, "CN=date=yy/mm/dd,weekday" aparece como está.
ADS_ESCAPEDMODE_OFF Valor: 3 Caracteres especiais ADSI são exibidos no formato sem escape; por exemplo, "CN=date=yy/mm/dd,weekday" aparece como "CN=date=yy/mm/dd,weekday".
ADS_ESCAPEDMODE_OFF_EX Valor: 4 Caracteres especiais ADSI e LDAP são exibidos no formato sem escape; por exemplo, "CN=date=yy/mm/dd,weekday" aparece como "CN=date=yy/mm/dd,weekday".

Comentários

Caracteres especiais devem ser escapados quando usados para fins não intencionais. Por exemplo, caracteres especiais LDAP, a vírgula (,) e o sinal de igual (=), são destinados como separadores de campo em um nome diferenciado, "CN=user,CN=users,DC=Fabrikam,DC=com". Quando um valor de atributo usa esses caracteres especiais, por exemplo, "CN=users,last name=Smith", esses caracteres especiais devem ser escapados conforme mostrado. Isso garante que um diretório compatível com LDAP, como o Active Directory, analise o caminho corretamente. No entanto, uma cadeia de caracteres de caminho de escape pode não parecer amigável em uma exibição. Nesse caso, você pode definir o ADS_ESCAPE_MODE_ENUM de forma que mostre o caminho como uma cadeia de caracteres sem escape, "CN=users,last name=Smith".

Da mesma forma, o caractere especial ADSI, a barra (/), separa elementos específicos do ADSI, "LDAP://server/CN=Jeff Smith,CN=Users,DC=Fabrikam,DC=com". Embora ele precise ser escapado quando usado para qualquer outra finalidade, por exemplo, "LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com". Você pode escolher uma opção ADS_ESCAPE_MODE_ENUM para exibir essa cadeia de caracteres de escape em uma forma legível por humanos: "LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com".

Atualmente, a barra (/) é o único caractere especial ADSI. O escape e o desenrolamento adsi se aplicam somente a caracteres especiais ADSI. A operação não afetará nenhum caractere especial LDAP, ou seja, eles não são escapados nem sem escape. Para obter mais informações e uma lista de caracteres especiais definidos pelo LDAP, consulte Caracteres especiais LDAP.

Para mostrar uma cadeia de caracteres de caminho sem escape, use a interface IADsPathname e seus métodos. Todas as outras APIs ADSI retornam a cadeia de caracteres de caminho de escape.

Para obter o comportamento correto, os caracteres especiais LDAP devem ser escapados antes que os caracteres especiais ADSI sejam escapados. A interface IADsPathname escapará dos caracteres na sequência correta.

Nota Como o VBScript não pode ler dados de uma biblioteca de tipos, os aplicativos VBScript (Visual Basic Scripting Edition) não reconhecem simbólicos, como constantes definidas acima. Em vez disso, use as constantes numéricas para definir os sinalizadores apropriados em seus aplicativos VBScript. Para usar as constantes simbólicas, escreva declarações explícitas dessas constantes, conforme feito aqui.

 

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	iads.h

Confira também

Enumerações ADSI

ADS_FORMAT_ENUM

IADsPathname

LDAP ADsPath