estrutura NAPI_PROVIDER_INSTALLATION_BLOB (nsemail.h)

Artigo
08/25/2023

A estrutura NAPI_PROVIDER_INSTALLATION_BLOB contém as informações necessárias para instalar um provedor de namespace para o namespace NS_EMAIL.

Sintaxe

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

Membros

dwVersion

Tipo: DWORD

O número de versão do provedor de namespace NS_EMAIL. Esse membro é específico para o provedor de namespace.

dwProviderType

Tipo: DWORD

O tipo de provedor de namespace para o namespace NS_EMAIL. Esse membro pode ser um dos valores do tipo de enumeração NAPI_PROVIDER_TYPE definido no arquivo de cabeçalho Nsemail.h .

fSupportsWildCard

Tipo: DWORD

Um valor booliano que indica se esse NS_EMAIL provedor de namespace dá suporte a nomes curinga. Se esse membro não for zero, um provedor de NS_EMAIL declara ser potencialmente capaz de resolve ou registrar qualquer nome que não pertença a nenhum domínio para o qual o provedor esteja especificamente registrado como primário ou secundário. Se esse membro não for zero, o provedor de NS_EMAIL poderá ser chamado para resolve ou registrar qualquer endereço, se nenhum provedor primário ou secundário para o domínio estiver disponível.

Pode haver vários provedores que afirmam ser capazes de resolve qualquer endereço (o fSupportsWildCard definido como diferente de zero). Se houver provedores de namespace com esse valor que também foram registrados como um provedor curinga, os provedores serão chamados na ordem em que aparecem no catálogo de namespaces do Winsock.

cDomains

Tipo: DWORD

O número de NAPI_DOMAIN_DESCRIPTION_BLOB estrutura a inicialização no membro OffsetFirstDomain usado para descrever domínios compatíveis com esse provedor de namespace NS_EMAIL.

OffsetFirstDomain

Tipo: DWORD

O deslocamento, em bytes, para o primeiro de várias estruturas de NAPI_DOMAIN_DESCRIPTION_BLOB usadas para descrever domínios compatíveis com esse provedor de namespace NS_EMAIL. Esse deslocamento deve ser alinhado em um limite mínimo de quatro bytes.

Comentários

Essa estrutura tem suporte no Windows Vista e posterior.

A estrutura NAPI_PROVIDER_INSTALLATION_BLOB contém as informações necessárias para instalar um provedor de namespace para o namespace NS_EMAIL. Pode haver vários provedores de namespace para a instalação do namespace NS_EMAIL em um sistema local.

Cada provedor de namespace registrado no namespace NS_EMAIL pode dar suporte a vários domínios. Como resultado, pode haver várias estruturas NAPI_DOMAIN_DESCRIPTION_BLOB na estrutura NAPI_PROVIDER_INSTALLATION_BLOB para um provedor de namespace NS_EMAIL. A lista de domínios com suporte é especificada no blob de registro do provedor como uma lista de estruturas de NAPI_DOMAIN_DESCRIPTION_BLOB . Cada especificação de domínio com suporte contém um valor NAPI_PROVIDER_LEVEL no membro AuthLevel do NAPI_DOMAIN_DESCRIPTION_BLOB que descreve o nível de autoridade fornecido pelo provedor para esse domínio.

Os provedores de namespace são chamados na ordem a seguir para resolve ou registrar um endereço em um domínio. Se um provedor de namespace registrado como o provedor primário para o domínio, esse provedor primário será chamado primeiro. Há dois casos dependendo se os resultados autoritativos são solicitados na consulta de namespace. O padrão de uma consulta é solicitar resultados autoritativos.

Quando os resultados autoritativos são solicitados na consulta, os provedores de namespace são chamados da seguinte maneira. Se o provedor primário não estiver disponível ou não puder resolve ou registrar o endereço, o primeiro provedor secundário no catálogo winsock será chamado. Se o provedor secundário não estiver disponível ou não puder resolve ou registrar o endereço, o próximo provedor secundário no catálogo winsock será chamado. Se todos os provedores secundários não estiverem disponíveis ou não puderem resolve ou registrar o endereço, o primeiro provedor curinga no catálogo winsock será chamado. Se o primeiro provedor curinga não estiver disponível ou não puder resolve ou registrar o endereço, o próximo provedor curinga no catálogo winsock será chamado.

Quando os resultados não autoritativos são solicitados na consulta, os provedores de namespace são chamados da seguinte maneira. O provedor primário, todos os provedores secundários e todos os provedores curinga são chamados e os resultados de todas as consultas são retornados. O provedor primário é chamado primeiro. Os provedores secundários são chamados em seguida, com base na ordem no catálogo do Winsock. Os provedores curinga são chamados em seguida, com base na ordem no catálogo do Winsock. Os resultados retornados são baseados na ordem das consultas.

As funções WSCInstallNameSpaceEx e WSCInstallNameSpaceEx32 são usadas para instalar um provedor de namespace para o namespace NS_EMAIL usando uma estrutura NAPI_PROVIDER_INSTALLATION_BLOB .

As funções WSAEnumNameSpaceProvidersEx e WSCEnumNameSpaceProvidersEx32 são usadas para enumerar todos os provedores de namespace (incluindo provedores de namespace NS_EMAIL) e para recuperar a estrutura NAPI_PROVIDER_INSTALLATION_BLOB para um provedor se o provedor registrou um blob após a instalação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	nsemail.h