структура NAPI_PROVIDER_INSTALLATION_BLOB (nsemail.h)
Структура 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 пространства имен. Это смещение должно быть выровнено не менее четырехбайтовой границы.
Комментарии
Эта структура поддерживается в Windows Vista и более поздних версиях.
Структура 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 |