ADS_ESCAPE_MODE_ENUM列舉 (iads.h)

發行項
02/28/2024

ADS_ESCAPE_MODE_ENUM列舉會指定逸出字元在目錄路徑中的顯示方式。

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;

常數

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，last name=Smith”，則必須逸出這些特殊字元，如下所示。這可確保符合 LDAP 規範的目錄，例如 Active Directory，將會正確剖析路徑。不過，逸出的路徑字串可能不會在顯示器上顯示為用戶易記。在此情況下，您可以設定 ADS_ESCAPE_MODE_ENUM ，讓路徑顯示為未逸出字元串 “CN=users，last name=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/加州，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 應用程式中的適當旗標。若要使用符號常數，請撰寫這類常數的明確宣告，如下所示。