структура NAPI_PROVIDER_INSTALLATION_BLOB (nsemail.h)

Статья
08/25/2023

Структура NAPI_PROVIDER_INSTALLATION_BLOB содержит сведения, необходимые для установки поставщика пространства имен для NS_EMAIL пространства имен.

Синтаксис

typedef struct napi_provider_installation_blob_tag {
  DWORD dwVersion;
  DWORD dwProviderType;
  DWORD fSupportsWildCard;
  ULONG cDomains;
  ULONG OffsetFirstDomain;
} NAPI_PROVIDER_INSTALLATION_BLOB;

Члены

dwVersion

Тип: DWORD

Номер версии поставщика пространства имен NS_EMAIL. Этот член зависит от поставщика пространства имен.

dwProviderType

Тип: DWORD

Тип поставщика пространства имен для NS_EMAIL пространства имен. Этот член может быть одним из значений из типа перечисления NAPI_PROVIDER_TYPE , определенного в файле заголовка Nsemail.h .

fSupportsWildCard

Тип: DWORD

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

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

cDomains

Тип: DWORD

Число NAPI_DOMAIN_DESCRIPTION_BLOB структур, начиная с члена OffsetFirstDomain , используемого для описания доменов, поддерживаемых этим поставщиком NS_EMAIL пространства имен.

OffsetFirstDomain

Тип: DWORD

Смещение (в байтах) к первой из нескольких структур NAPI_DOMAIN_DESCRIPTION_BLOB , используемых для описания доменов, поддерживаемых поставщиком NS_EMAIL пространства имен. Это смещение должно быть выровнено не менее четырехбайтовой границы.

Структура NAPI_PROVIDER_INSTALLATION_BLOB содержит сведения, необходимые для установки поставщика пространства имен для NS_EMAIL пространства имен. Для NS_EMAIL пространства имен, устанавливаемого в локальной системе, может быть несколько поставщиков пространств имен.

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

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

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

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

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

Функции WSAEnumNameSpaceProvidersEx и WSCEnumNameSpaceProvidersEx32 используются для перечисления всех поставщиков пространств имен (включая поставщиков пространств имен NS_EMAIL) и получения структуры NAPI_PROVIDER_INSTALLATION_BLOB для поставщика, если поставщик зарегистрировал BLOB-объекты после установки.

Требования

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