ADS_ESCAPE_MODE_ENUM 枚举 (iads.h)

项目
03/05/2024

ADS_ESCAPE_MODE_ENUM枚举指定转义字符在目录路径中的显示方式。

语法

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;

常量

ADS_ESCAPEDMODE_DEFAULT
值：1
默认转义模式提供了一个用于指定转义模式的便捷选项。它具有适用于所选格式的最小转义操作的效果。因此，默认行为取决于 ADS_FORMAT_ENUM 用于检索目录路径的值。

检索到的路径格式	默认转义模式
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
值： 2
所有特殊字符都以转义格式显示：例如，“CN=date=yy/mm/dd，weekday”按原样显示。

ADS_ESCAPEDMODE_OFF
值： 3
ADSI 特殊字符以未转义格式显示;例如，“CN=date=yy/mm/dd，weekday”显示为“CN=date=yy/mm/dd，weekday”。

ADS_ESCAPEDMODE_OFF_EX
值： 4
ADSI 和 LDAP 特殊字符以非转义格式显示;例如，“CN=date=yy/mm/dd，weekday”显示为“CN=date=yy/mm/dd，weekday”。

注解

当用于任何意外目的时，必须转义特殊字符。例如，LDAP 特殊字符（逗号 (，) 和等号 (=) ）用作可分辨名称“CN=user，CN=users，DC=Fabrikam，DC=com”的字段分隔符。当属性值使用此类特殊字符（例如“CN=users，姓氏=Smith”）时，必须按如下所示转义这些特殊字符。这可确保符合 LDAP 的目录（如 Active Directory）能够正确分析路径。但是，转义路径字符串在显示器上可能看起来不是用户友好的。在这种情况下，可以设置 ADS_ESCAPE_MODE_ENUM 的方式，将路径显示为未转义的字符串“CN=users，姓氏=Smith”。

同样，ADSI 特殊字符斜杠标记 (/) 分隔 ADSI 特定的元素“LDAP://server/CN=Jeff Smith，CN=Users，DC=Fabrikam，DC=com”。尽管当用于任何其他目的时，必须转义它，例如，“LDAP://server/CN=Jeff Smith/California，CN=Users，DC=Fabrikam，DC=com”。可以选择 ADS_ESCAPE_MODE_ENUM 选项以人类可读的形式显示此转义字符串：“LDAP://server/CN=Jeff Smith/California，CN=Users，DC=Fabrikam，DC=com”。

目前，斜杠标记 (/) 是唯一的 ADSI 特殊字符。 ADSI 转义和取消转义仅适用于 ADSI 特殊字符。该操作不会影响任何 LDAP 特殊字符，即它们既不转义也不转义。有关详细信息以及 LDAP 定义的特殊字符列表，请参阅 LDAP 特殊字符。

若要显示未转义的路径字符串，请使用 IADsPathname 接口及其方法。所有其他 ADSI API 返回转义路径字符串。

若要获取正确行为，必须在转义 ADSI 特殊字符之前对 LDAP 特殊字符进行转义。 IADsPathname 接口将以正确的顺序转义字符。

注意由于 VBScript 无法从类型库读取数据，因此 Visual Basic Scripting Edition (VBScript) 应用程序无法识别符号，如上面定义的常量。请改用数字常量在 VBScript 应用程序中设置适当的标志。若要使用符号常量，请编写此类常量的显式声明，如下所示。