Freigeben über


ADS_SCOPEENUM-Enumeration (iads.h)

Die ADS_SCOPEENUM-Enumeration gibt den Bereich einer Verzeichnissuche an.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0021 {
  ADS_SCOPE_BASE = 0,
  ADS_SCOPE_ONELEVEL = 1,
  ADS_SCOPE_SUBTREE = 2
} ADS_SCOPEENUM;

Konstanten

 
ADS_SCOPE_BASE
Wert: 0
Beschränkt die Suche auf das Basisobjekt. Das Ergebnis enthält höchstens ein Objekt.
ADS_SCOPE_ONELEVEL
Wert: 1
Durchsucht eine Ebene der unmittelbar untergeordneten Elemente, wobei das Basisobjekt ausgeschlossen ist.
ADS_SCOPE_SUBTREE
Wert: 2
Durchsucht die gesamte Unterstruktur, einschließlich aller untergeordneten Elemente und des Basisobjekts selbst.

Hinweise

Wenn Sie den Suchbereich nicht explizit festlegen, ist der Standardwert ADS_SCOPE_SUBTREE.

Da VBScript keine Daten aus einer Typbibliothek lesen kann, erkennen VBScript-Anwendungen die oben definierten symbolischen Konstanten nicht. Verwenden Sie stattdessen die numerischen Konstanten, um die entsprechenden Flags in Ihren VBScript-Anwendungen festzulegen. Um die symbolischen Konstanten als gute Programmierpraxis zu verwenden, erstellen Sie explizite Deklarationen dieser Konstanten, wie hier in Ihren VBScript-Anwendungen geschehen.

Beispiele

Der Suchbereich ist eine der Sucheinstellungen, die Clients angeben können. Das folgende Codebeispiel zeigt, wie Dies mithilfe der ADS_SEARCHPREF_INFO-Struktur zusammen mit den im ADS_SEARCHPREF_ENUM und dieser Enumeration definierten Elementen erreicht wird.

ADS_SEARCHPREF_INFO prefInfo;
prefInfo.dwSearchPref = ADS_SEARCHPREF_SEARCH_SCOPE;
prefInfo.vValue.dwType = ADSTYPE_INTEGER;
prefInfo.vValue.Integer = ADS_SCOPE_SUBTREE;

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Kopfzeile iads.h

Weitere Informationen

ADSI-Enumerationen

ADS_SEARCHPREF_ENUM

ADS_SEARCHPREF_INFO