enumeración ADS_ESCAPE_MODE_ENUM (iads.h)
La enumeración ADS_ESCAPE_MODE_ENUM especifica cómo se muestran los caracteres de escape en una ruta de acceso de directorio.
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_DEFAULTValor: 1 El modo de escape predeterminado proporciona una opción cómoda para especificar el modo de escape. Tiene el efecto de una operación de escape mínima adecuada para un formato elegido. Por lo tanto, el comportamiento predeterminado depende del valor que ADS_FORMAT_ENUM usa para recuperar las rutas de acceso del directorio.
|
||||||||||||||||||||
ADS_ESCAPEDMODE_ONValor: 2 Todos los caracteres especiales se muestran en el formato de escape; por ejemplo, "CN=date=yy/mm/dd,weekday" aparece tal cual. |
||||||||||||||||||||
ADS_ESCAPEDMODE_OFFValor: 3 Los caracteres especiales ADSI se muestran en el formato sin escape; por ejemplo, "CN=date=yy/mm/dd,weekday" aparece como "CN=date=yy/mm/dd,weekday". |
||||||||||||||||||||
ADS_ESCAPEDMODE_OFF_EXValor: 4 Los caracteres especiales ADSI y LDAP se muestran en el formato sin escape; por ejemplo, "CN=date=yy/mm/dd,weekday" aparece como "CN=date=yy/mm/dd,weekday". |
Comentarios
Los caracteres especiales deben tener caracteres de escape cuando se usen con fines no deseados. Por ejemplo, los caracteres especiales LDAP, la coma (,) y el signo igual (=) están pensados como separadores de campo en un nombre distintivo, "CN=user,CN=users,DC=Fabrikam,DC=com". Cuando un valor de atributo usa estos caracteres especiales, por ejemplo, "CN=users,last name=Smith", estos caracteres especiales deben escaparse como se muestra. Esto garantiza que un directorio compatible con LDAP, como Active Directory, analice correctamente la ruta de acceso. Sin embargo, es posible que una cadena de ruta de acceso de escape no parezca fácil de usar en una pantalla. En este caso, puede establecer el ADS_ESCAPE_MODE_ENUM de tal manera que muestre la ruta de acceso como una cadena sin escape, "CN=users,apellidos=Smith".
Del mismo modo, el carácter especial ADSI, la marca diagonal (/), separa los elementos específicos de ADSI, "LDAP://server/CN=Jeff Smith,CN=Users,DC=Fabrikam,DC=com". Aunque se debe escapar cuando se usa para cualquier otro propósito, por ejemplo, "LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com". Puede elegir una opción de ADS_ESCAPE_MODE_ENUM para mostrar esta cadena de escape en un formato legible: "LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com".
Actualmente, la marca de barra diagonal (/) es el único carácter especial ADSI. El escape de ADSI y la descaptura solo se aplica a los caracteres especiales ADSI. La operación no afectará a ningún carácter especial LDAP, es decir, no se aplica escape ni sin escape. Para obtener más información y una lista de caracteres especiales definidos por LDAP, vea Caracteres especiales LDAP.
Para mostrar una cadena de ruta de acceso sin escape, use la interfaz IADsPathname y sus métodos. Todas las demás API adsi devuelven la cadena de ruta de acceso de escape.
Para obtener un comportamiento correcto, los caracteres especiales LDAP deben escaparse antes de que se escapen los caracteres especiales ADSI. La interfaz IADsPathname escapará los caracteres de la secuencia correcta.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Encabezado | iads.h |