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_BASEWert: 0 Beschränkt die Suche auf das Basisobjekt. Das Ergebnis enthält höchstens ein Objekt. |
ADS_SCOPE_ONELEVELWert: 1 Durchsucht eine Ebene der unmittelbar untergeordneten Elemente, wobei das Basisobjekt ausgeschlossen ist. |
ADS_SCOPE_SUBTREEWert: 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 |