Поделиться через

перечисление ADS_SCOPEENUM (iads.h)

  • Статья

Перечисление ADS_SCOPEENUM указывает область поиска в каталоге.

Синтаксис

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

Константы

 
ADS_SCOPE_BASE
Значение: 0
Ограничивает поиск базовым объектом. Результат содержит не более одного объекта.
ADS_SCOPE_ONELEVEL
Значение: 1
Выполняет поиск одного уровня непосредственных дочерних элементов, за исключением базового объекта.
ADS_SCOPE_SUBTREE
Значение: 2
Выполняет поиск по всему поддереву, включая все дочерние элементы и сам базовый объект.

Комментарии

Если явно не задать область поиска, по умолчанию используется ADS_SCOPE_SUBTREE.

Так как VBScript не может считывать данные из библиотеки типов, приложения VBScript не распознают символьные константы, как определено выше. Вместо этого используйте числовые константы, чтобы задать соответствующие флаги в приложениях VBScript. Чтобы использовать символьные константы в качестве рекомендуемого метода программирования, создайте явные объявления таких констант, как показано здесь, в приложениях VBScript.

Примеры

Поиск область является одним из параметров поиска, которые клиенты могут указать. В следующем примере кода показано, как это сделать с помощью структуры ADS_SEARCHPREF_INFO вместе с элементами, определенными в ADS_SEARCHPREF_ENUM и в этом перечислении.

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

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Верхняя часть iads.h

См. также раздел

Перечисления ADSI

ADS_SEARCHPREF_ENUM

ADS_SEARCHPREF_INFO