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

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

  • Статья

Перечисление ADS_CHASE_REFERRALS_ENUM указывает, происходит ли и как выполняется отслеживание ссылок. Когда сервер определяет, что другие серверы содержат соответствующие данные, частично или в целом, он может направить клиента на другой сервер для получения результата. Поиск ссылок — это действие, выполняемое клиентом для связи с указанным сервером для продолжения поиска в каталоге.

Синтаксис

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0024 {
  ADS_CHASE_REFERRALS_NEVER = 0,
  ADS_CHASE_REFERRALS_SUBORDINATE = 0x20,
  ADS_CHASE_REFERRALS_EXTERNAL = 0x40,
  ADS_CHASE_REFERRALS_ALWAYS
} ADS_CHASE_REFERRALS_ENUM;

Константы

 
ADS_CHASE_REFERRALS_NEVER
Значение: 0
Клиент никогда не должен преследовать указанный сервер. Этот режим позволяет избежать обращения клиента к другим серверам в процессе отсылки.
ADS_CHASE_REFERRALS_SUBORDINATE
Значение: 0x20
Клиент охотится только за подчиненными рефералами, которые являются контекстом именования подчиненных в дереве каталогов. Например, если базовый поиск запрашивается для "DC=Fabrikam,DC=Com", а сервер возвращает результирующий набор и ссылку "DC=Sales,DC=Fabrikam,DC=Com" на сервере AdbSales, клиент может связаться с сервером AdbSales, чтобы продолжить поиск. Поставщик ADSI LDAP всегда снимает этот флаг для операций поиска с постраничным выводом.
ADS_CHASE_REFERRALS_EXTERNAL
Значение: 0x40
Клиент охотится за внешними рефералами. Например, клиент запрашивает сервер A для выполнения поиска по запросу "DC=Fabrikam,DC=Com". Однако сервер A не содержит объект , но знает, что им владеет независимый сервер B. Затем клиент ссылается на сервер B.
ADS_CHASE_REFERRALS_ALWAYS
Рефералы преследуются для подчиненного или внешнего типа.

Комментарии

Используйте константы этого перечисления, чтобы настроить параметры поиска для поиска ссылок. Действие равносильно назначению соответствующих полей структуры ADS_SEARCHPREF_INFO с элементами перечисления ADS_CHASE_REFERRALS_ENUM и ADS_SEARCHPREF_ENUM . Значения этого перечисления также можно использовать с IADsObjectOptions , чтобы указать, следует ли выполнять отслеживание ссылок при перечислении объектов в объекте контейнера.

Интерфейс IADsNameTranslate имеет частичную реализацию ADS_CHASE_REFERRALS_ENUM через свойство ChaseReferral . Если свойство ChaseReferral равно нулю (0), это то же самое, что и при указании ADS_CHASE_REFERRALS_NEVER (0). Если используется ненулевое значение, оно аналогично указанию ADS_CHASE_REFERRALS_ALWAYS (0x60). IADsNameTranslate не реализует параметры ADS_CHASE_REFERRALS_SUBORDINATE (0x20) или ADS_CHASE_REFERRALS_EXTERNAL (0x40).

Поставщик ADSI LDAP поддерживает внешние рефералы для постраничного поиска, но не поддерживает подчиненные рефералы во время разбиения по страницам.

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

Требования

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

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

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

ADS_SEARCHPREF_ENUM

ADS_SEARCHPREF_INFO

IADsNameTranslate

IADsObjectOptions