перечисление NAPI_PROVIDER_LEVEL (nsemail.h)

Статья
03/05/2024

Перечисление NAPI_PROVIDER_LEVEL указывает уровень полномочий поставщика NS_EMAIL поставщика пространства имен для заданного домена.

Синтаксис

typedef enum napi_provider_level_tag {
  ProviderLevel_None = 0,
  ProviderLevel_Secondary,
  ProviderLevel_Primary
} NAPI_PROVIDER_LEVEL;

Константы


`ProviderLevel_None` Значение: 0 Поставщик пространства имен не поддерживает текущий домен. Это значение можно использовать для временного отключения поддержки домена, не удаляя его из списка поддерживаемых доменов. Если ProviderLevel_None задано в элементе AuthLevelNAPI_DOMAIN_DESCRIPTION_BLOB для заданного домена при установке и регистрации поставщика, поставщик пространства имен не будет вызываться для разрешения или регистрации адреса в этом домене, если поставщик не зарегистрирован в качестве поставщика с подстановочными знаками. Для домена может быть несколько поставщиков NS_EMAIL пространств имен со значением ProviderLevel_None. Если есть поставщики пространства имен с этим значением, которые также зарегистрированы в качестве поставщика с подстановочными знаками, поставщики вызываются в том порядке, в который они отображаются в каталоге Winsock.
`ProviderLevel_Secondary` Поставщик пространства имен — это дополнительный поставщик для домена в пространстве имен NS_EMAIL. Поставщик пространства имен может быть вторичным поставщиком в целевом домене, если поставщик может разрешать и регистрировать имена NS_EMAIL для этого домена и давать тот же ответ, что и основной поставщик. Если ProviderLevel_Secondary задано в элементе AuthLevelNAPI_DOMAIN_DESCRIPTION_BLOB для заданного домена при установке и регистрации поставщика, этот поставщик вызывается, если основной поставщик для домена в настоящее время недоступен или основной поставщик не может разрешить или зарегистрировать адрес в этом домене. Для домена может быть несколько поставщиков дополнительных NS_EMAIL пространств имен со значением ProviderLevel_Secondary. Если есть несколько поставщиков вторичного пространства имен, поставщики вызываются в том порядке, в который они отображаются в каталоге Winsock.
`ProviderLevel_Primary` Поставщик пространства имен является основным поставщиком домена в пространстве имен NS_EMAIL. Поставщик пространства имен может претендовать на то, чтобы быть основным поставщиком для домена, если он владеет всеми именами NS_EMAIL для этого домена и, таким образом, имеет доступ к данным master для всех таких имен. Для домена, зарегистрированного в локальной системе, должен быть только один основной поставщик пространства имен NS_EMAIL. Примечание Никогда не должно быть двух поставщиков NS_EMAIL пространств имен, которые утверждают, что являются основным поставщиком для одного домена. Если несколько поставщиков пытаются зарегистрироваться в качестве основного поставщика для одного домена, будет вызван первый поставщик, найденный в каталоге пространства имен Winsock для домена в качестве основного поставщика. Все остальные утверждения поставщика, которые являются основным поставщиком, игнорируются.

Перечисление NAPI_PROVIDER_LEVEL используется структурой NAPI_DOMAIN_DESCRIPTION_BLOB для указания уровня полномочий поставщика пространства имен NS_EMAIL для домена. Каждый поставщик пространства имен, зарегистрированный в пространстве имен NS_EMAIL, может поддерживать несколько доменов. Список поддерживаемых доменов указывается в большом двоичном объекте регистрации поставщика в виде списка NAPI_DOMAIN_DESCRIPTION_BLOB структур. Каждая поддерживаемая спецификация домена содержит значение NAPI_PROVIDER_LEVEL в элементе AuthLevelNAPI_DOMAIN_DESCRIPTION_BLOB , описывающее тип поддержки, предоставляемой поставщиком для этого домена.

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

Поставщики пространств имен вызываются в следующем порядке для разрешения или регистрации адреса в домене. Если поставщик пространства имен зарегистрирован в качестве основного поставщика для домена, этот поставщик вызывается первым. Существует два случая в зависимости от того, запрашиваются ли достоверные результаты в запросе пространства имен. По умолчанию запрос запрашивает достоверные результаты.

Когда в запросе запрашиваются достоверные результаты, поставщики пространства имен вызываются следующим образом. Если основной поставщик недоступен или не может разрешить или зарегистрировать адрес, вызывается первый вторичный поставщик в каталоге Winsock. Если дополнительный поставщик недоступен или не может разрешить или зарегистрировать адрес, вызывается следующий вторичный поставщик в каталоге Winsock. Если все вторичные поставщики недоступны или не могут разрешить или зарегистрировать адрес, вызывается первый поставщик с подстановочными знаками в каталоге Winsock. Если первый поставщик с подстановочными знаками недоступен или не может разрешить или зарегистрировать адрес, вызывается следующий поставщик подстановочных знаков в каталоге Winsock.

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

Структура NAPI_DOMAIN_DESCRIPTION_BLOB используется в структуре NAPI_PROVIDER_INSTALLATION_BLOB для описания поставщика пространства имен NS_EMAIL.

Функции WSCInstallNameSpaceEx и WSCInstallNameSpaceEx32 используются для установки поставщика пространства имен для NS_EMAIL пространства имен с помощью структуры NAPI_PROVIDER_INSTALLATION_BLOB .

Функции WSAEnumNameSpaceProvidersEx и WSCEnumNameSpaceProvidersEx32 используются для перечисления поставщиков пространств имен для NS_EMAIL пространства имен и получения структуры NAPI_PROVIDER_INSTALLATION_BLOB для поставщика.

Требования

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