ADS_SCOPEENUM-Enumeration (iads.h)

Artikel
03/06/2024

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;