ADS_ESCAPE_MODE_ENUM-Enumeration (iads.h)
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_DEFAULTWert: 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.
|
||||||||||||||||||||
ADS_ESCAPEDMODE_ONWert: 2 Alle Sonderzeichen werden im Escapeformat angezeigt; Beispielsweise wird "CN=date=yy/mm/tt,Wochentag" unverändert angezeigt. |
||||||||||||||||||||
ADS_ESCAPEDMODE_OFFWert: 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_EXWert: 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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Kopfzeile | iads.h |