ADS_ESCAPE_MODE_ENUM-Enumeration (iads.h)

Artikel
08/24/2023

Die ADS_ESCAPE_MODE_ENUM-Enumeration gibt an, wie Escapezeichen in einem Verzeichnispfad angezeigt werden.

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;

Konstanten

ADS_ESCAPEDMODE_DEFAULT
Wert: 1
Der Standard-Escapemodus bietet eine praktische Option zum Angeben des Escapemodus. Dies hat den Effekt eines minimalen Escapevorgangs, der für ein ausgewähltes Format geeignet ist. Daher hängt das Standardverhalten von dem Wert ab, den ADS_FORMAT_ENUM zum Abrufen der Verzeichnispfade verwendet.

Abgerufenes Pfadformat	Standardmäßiger Escapemodus
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
Wert: 2
Alle Sonderzeichen werden im Escapeformat angezeigt; Beispielsweise wird "CN=date=yy/mm/tt,Wochentag" unverändert angezeigt.

ADS_ESCAPEDMODE_OFF
Wert: 3
ADSI-Sonderzeichen werden im unescaped-Format angezeigt; beispielsweise wird "CN=date=yy/mm/tt,wochentag" als "CN=date=yy/mm/tt,wochentag" angezeigt.

ADS_ESCAPEDMODE_OFF_EX
Wert: 4
ADSI- und LDAP-Sonderzeichen werden im unescaped-Format angezeigt; beispielsweise wird "CN=date=yy/mm/tt,wochentag" als "CN=date=yy/mm/tt,wochentag" angezeigt.

Hinweise

Sonderzeichen müssen als Escapezeichen verwendet werden, wenn sie für unbeabsichtigte Zwecke verwendet werden. Beispielsweise sind LDAP-Sonderzeichen, das Komma (,) und das Gleichheitszeichen (=) als Feldtrennzeichen in einem distinguished Name vorgesehen: "CN=user,CN=users,DC=Fabrikam,DC=com". Wenn ein Attributwert solche Sonderzeichen verwendet, z. B. "CN=users,last name=Smith", müssen diese Sonderzeichen wie gezeigt mit einem Escapezeichen versehen werden. Dadurch wird sichergestellt, dass ein LDAP-kompatibles Verzeichnis, z. B. Active Directory, den Pfad ordnungsgemäß analysiert. Eine Escapepfadzeichenfolge scheint jedoch auf einer Anzeige möglicherweise nicht benutzerfreundlich zu sein. In diesem Fall können Sie die ADS_ESCAPE_MODE_ENUM so festlegen, dass der Pfad als nicht dargestellte Zeichenfolge "CN=users,last name=Smith" angezeigt wird.

In ähnlicher Weise trennt das ADSI-Sonderzeichen , Schrägstrich (/), ADSI-spezifische Elemente, "LDAP://server/CN=Jeff Smith,CN=Users,DC=Fabrikam,DC=com". Es muss zwar escaped sein, wenn es für andere Zwecke verwendet wird, z. B. "LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com". Sie können eine ADS_ESCAPE_MODE_ENUM Option auswählen, um diese mit Escapezeichen versehene Zeichenfolge in einer lesbaren Form anzuzeigen: "LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com".

Derzeit ist die Schrägstrichmarke (/) das einzige ADSI-Sonderzeichen. ADSI escaping und Unescaping gilt nur für ADSI-Sonderzeichen. Der Vorgang wirkt sich nicht auf LDAP-Sonderzeichen aus, d. h. sie sind weder escaped noch unescaped. Weitere Informationen und eine Liste der durch LDAP definierten Sonderzeichen finden Sie unter LDAP-Sonderzeichen.

Verwenden Sie die IADsPathname-Schnittstelle und die zugehörigen Methoden, um die Zeichenfolge für nicht gescapeten Pfad anzuzeigen. Alle anderen ADSI-APIs geben die Escapepfadzeichenfolge zurück.

Um ein korrektes Verhalten zu erhalten, müssen die LDAP-Sonderzeichen mit Escapezeichen versehen werden, bevor die ADSI-Sonderzeichen mit Escapezeichen versehen werden. Die IADsPathname-Schnittstelle escapet die Zeichen in der richtigen Sequenz.

Hinweis Da VBScript keine Daten aus einer Typbibliothek lesen kann, erkennen Visual Basic Scripting Edition-Anwendungen (VBScript) nicht symbolisch als oben definierte Konstanten. Verwenden Sie stattdessen die numerischen Konstanten, um die entsprechenden Flags in Ihren VBScript-Anwendungen festzulegen. Um die symbolischen Konstanten zu verwenden, schreiben Sie explizite Deklarationen solcher Konstanten, wie hier geschehen.