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

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

  • Статья

Перечисление ADS_PREFERENCES_ENUM указывает параметры запроса поставщика OLE DB для ADSI.

Синтаксис

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0022 {
  ADSIPROP_ASYNCHRONOUS = 0,
  ADSIPROP_DEREF_ALIASES = 0x1,
  ADSIPROP_SIZE_LIMIT = 0x2,
  ADSIPROP_TIME_LIMIT = 0x3,
  ADSIPROP_ATTRIBTYPES_ONLY = 0x4,
  ADSIPROP_SEARCH_SCOPE = 0x5,
  ADSIPROP_TIMEOUT = 0x6,
  ADSIPROP_PAGESIZE = 0x7,
  ADSIPROP_PAGED_TIME_LIMIT = 0x8,
  ADSIPROP_CHASE_REFERRALS = 0x9,
  ADSIPROP_SORT_ON = 0xa,
  ADSIPROP_CACHE_RESULTS = 0xb,
  ADSIPROP_ADSIFLAG = 0xc
} ADS_PREFERENCES_ENUM;

Константы

 
ADSIPROP_ASYNCHRONOUS
Значение: 0
Запрашивает асинхронный поиск.
ADSIPROP_DEREF_ALIASES
Значение: 0x1
Указывает, что псевдонимы найденных объектов должны быть разрешены. Используйте ADS_DEREFENUM , чтобы указать способ выполнения этой операции.
ADSIPROP_SIZE_LIMIT
Значение: 0x2
Указывает ограничение размера, которое сервер должен соблюдать при поиске. Максимальный размер — это максимальное количество возвращаемых объектов. Нулевое значение указывает, что ограничение на размер не налагается. Сервер прекращает поиск после достижения предельного размера и возвращает результаты, накопленные до этого момента.
ADSIPROP_TIME_LIMIT
Значение: 0x3
Указывает ограничение времени (в секундах), которое сервер должен наблюдать при поиске. Нулевое значение указывает, что ограничение по времени не налагается. По достижении предельного времени сервер прекращает поиск и возвращает результаты, накопленные к этой точке.
ADSIPROP_ATTRIBTYPES_ONLY
Значение: 0x4
Указывает, что поиск должен получить только имя атрибутов, которым были назначены значения.
ADSIPROP_SEARCH_SCOPE
Значение: 0x5
Указывает область поиска, который должен наблюдаться сервером. Дополнительные сведения о соответствующих параметрах см. в перечислении ADS_SCOPEENUM .
ADSIPROP_TIMEOUT
Значение: 0x6
Указывает ограничение времени (в секундах), которое клиент будет ожидать, пока сервер вернет результат.
ADSIPROP_PAGESIZE
Значение: 0x7
Указывает размер страницы в поиске по страницам. Для каждого запроса клиента сервер возвращает не более количества объектов, заданных размером страницы.
ADSIPROP_PAGED_TIME_LIMIT
Значение: 0x8
Указывает ограничение времени (в секундах), которое сервер должен наблюдать для поиска на странице результатов; это не соответствует ограничению времени для всего поиска.
ADSIPROP_CHASE_REFERRALS
Значение: 0x9
Указывает, что рефералы могут преследоваться. Если корневой поиск не указан в контексте именования сервера или когда результаты поиска пересекают контекст именования (например, если у вас есть дочерние домены и поиск в родительском домене), сервер отправляет клиенту реферальные сообщения, которые клиент может игнорировать или преследовать. По умолчанию этот параметр имеет значение ADS_CHASE_REFERRALS_EXTERNAL. Дополнительные сведения о поиске рефералов см. в разделе ADS_CHASE_REFERRALS_ENUM.
ADSIPROP_SORT_ON
Значение: 0xa
Указывает, что сервер сортирует результирующий набор. Используйте структуру ADS_SORTKEY для указания ключей сортировки.
ADSIPROP_CACHE_RESULTS
Значение: 0xb
Указывает, следует ли кэшировать результат на стороне клиента. По умолчанию ADSI кэширует результирующий набор. Отключение этого параметра может быть более предпочтительным для больших результирующих наборов.
ADSIPROP_ADSIFLAG
Значение: 0xc
Позволяет клиенту OLEDB указать флаги привязки, которые будут использоваться при привязке к серверу. Допустимые значения — это значения, разрешенные ADsOpenObject. Доступ к нему осуществляется из скриптов ADO, используя имя свойства "ФЛАГ ADSI".

Комментарии

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

Требования

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

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

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

ADS_CHASE_REFERRALS_ENUM

ADS_DEREFENUM

ADS_SCOPEENUM

ADS_SORTKEY