Compartilhar via


enumeração NAPI_PROVIDER_LEVEL (nsemail.h)

A enumeração NAPI_PROVIDER_LEVEL especifica o nível de autoridade do provedor de um provedor de namespace NS_EMAIL para um determinado domínio.

Syntax

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

Constantes

 
ProviderLevel_None
Valor: 0
O provedor de namespace não dá suporte ao domínio atual. Esse valor pode ser usado para desativar temporariamente o suporte para um domínio sem removê-lo da lista de domínios com suporte.

Se ProviderLevel_None for definido no membro AuthLevel do NAPI_DOMAIN_DESCRIPTION_BLOB para um determinado domínio quando o provedor for instalado e registrado, o provedor de namespace não será chamado para resolve ou registrar um endereço nesse domínio, a menos que o provedor esteja registrado como um provedor curinga.

Pode haver vários provedores de namespace NS_EMAIL para um domínio com um valor de ProviderLevel_None. 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 do Winsock.
ProviderLevel_Secondary
O provedor de namespace é um provedor secundário para um domínio no namespace NS_EMAIL. Um provedor de namespace poderá ser um provedor secundário no domínio de destino se o provedor puder resolve e registrar NS_EMAIL nomes para esse domínio e fornecer a mesma resposta que um provedor primário forneceria. Se ProviderLevel_Secondary for definido no membro AuthLevel do NAPI_DOMAIN_DESCRIPTION_BLOB para um determinado domínio quando o provedor estiver instalado e registrado, esse provedor será chamado quando um provedor primário para o domínio não estiver disponível no momento ou o provedor primário não puder resolve ou registrar o endereço nesse domínio.

Pode haver vários provedores de namespace de NS_EMAIL secundários para um domínio com um valor de ProviderLevel_Secondary. Se houver vários provedores de namespace secundários, os provedores serão chamados na ordem em que aparecem no catálogo do Winsock.
ProviderLevel_Primary
O provedor de namespace é o provedor primário de um domínio no namespace NS_EMAIL. Um provedor de namespace pode declarar ser o provedor primário de um domínio se ele possui todos os nomes de NS_EMAIL para esse domínio e, portanto, tem acesso aos dados master para todos esses nomes.

Deve haver apenas um único provedor de namespace NS_EMAIL primário para um domínio registrado no sistema local.

Nota Nunca deve haver dois provedores de namespace NS_EMAIL que afirmam ser o provedor primário para o mesmo domínio. Se vários provedores tentarem se registrar como o provedor primário para o mesmo domínio, o primeiro provedor encontrado no catálogo de namespaces winsock para o domínio como o provedor primário será chamado. Todas as outras declarações de provedor para ser o provedor primário são ignoradas.

 

Comentários

Essa enumeração tem suporte no Windows Vista e posterior.

A enumeração NAPI_PROVIDER_LEVEL é usada pela estrutura NAPI_DOMAIN_DESCRIPTION_BLOB para especificar o nível de autoridade de um provedor de namespace NS_EMAIL para um domínio. Cada provedor de namespace registrado no namespace NS_EMAIL pode dar suporte a vários domínios. 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 tipo de suporte fornecido pelo provedor para esse domínio.

Além do domínio especificado, um provedor de namespace NS_EMAIL também pode se registrar como um provedor curinga para tentar dar suporte a qualquer domínio, especificando o membro fSupportsWildCard como diferente de zero no NAPI_PROVIDER_INSTALLATION_BLOB passado quando o provedor é instalado.

Os provedores de namespace são chamados na seguinte ordem 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 para 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 do 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 do 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 do 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 do 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.

A estrutura NAPI_DOMAIN_DESCRIPTION_BLOB é usada na estrutura NAPI_PROVIDER_INSTALLATION_BLOB para descrever um provedor de namespace NS_EMAIL.

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 provedores de namespace para o namespace NS_EMAIL e recuperar a estrutura NAPI_PROVIDER_INSTALLATION_BLOB para um provedor.

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

Confira também

NAPI_DOMAIN_DESCRIPTION_BLOB

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32