enumeración NAPI_PROVIDER_LEVEL (nsemail.h)

La enumeración NAPI_PROVIDER_LEVEL especifica el nivel de autoridad del proveedor de un proveedor de espacio de nombres NS_EMAIL para un dominio determinado.

Syntax

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

Constantes

ProviderLevel_None Valor: 0 El proveedor de espacios de nombres no admite el dominio actual. Este valor se puede usar para desactivar temporalmente la compatibilidad con un dominio sin quitarlo de la lista de dominios admitidos. Si ProviderLevel_None se establece en el miembro AuthLevel del NAPI_DOMAIN_DESCRIPTION_BLOB para un dominio determinado cuando el proveedor está instalado y registrado, no se llamará al proveedor de espacios de nombres para resolver o registrar una dirección en ese dominio a menos que el proveedor se registre como proveedor de caracteres comodín. Puede haber varios proveedores de espacios de nombres NS_EMAIL para un dominio con un valor de ProviderLevel_None. Si hay proveedores de espacios de nombres con este valor que también se registraron como proveedor de caracteres comodín, se llama a los proveedores en el orden en que aparecen en el catálogo winsock.
ProviderLevel_Secondary El proveedor de espacios de nombres es un proveedor secundario para un dominio del espacio de nombres NS_EMAIL. Un proveedor de espacios de nombres puede ser un proveedor secundario en el dominio de destino si el proveedor puede resolver y registrar NS_EMAIL nombres para este dominio y dar la misma respuesta que proporcionaría un proveedor principal. Si ProviderLevel_Secondary se establece en el miembro AuthLevel del NAPI_DOMAIN_DESCRIPTION_BLOB para un dominio determinado cuando se instala y registra el proveedor, se llama a este proveedor cuando un proveedor principal del dominio no está disponible actualmente o el proveedor principal no pudo resolver ni registrar la dirección en ese dominio. Puede haber varios proveedores de espacios de nombres NS_EMAIL secundarios para un dominio con un valor de ProviderLevel_Secondary. Si hay varios proveedores de espacios de nombres secundarios, se llama a los proveedores en el orden en que aparecen en el catálogo winsock.
ProviderLevel_Primary El proveedor de espacios de nombres es el proveedor principal de un dominio del espacio de nombres NS_EMAIL. Un proveedor de espacios de nombres puede reclamar ser el proveedor principal de un dominio si posee todos los nombres de NS_EMAIL para ese dominio y, por tanto, tiene acceso a los datos maestros para todos estos nombres. Solo debe haber un único proveedor de espacio de nombres NS_EMAIL principal para un dominio registrado en el sistema local. Nota Nunca debe haber dos proveedores de espacio de nombres NS_EMAIL que notificaciones sean el proveedor principal para el mismo dominio. Si varios proveedores intentan registrarse como proveedor principal para el mismo dominio, se llamará al primer proveedor que se encuentra en el catálogo de espacios de nombres winsock para el dominio, ya que se llamará al proveedor principal. Se omiten todas las demás notificaciones de proveedor para que sean el proveedor principal.

Comentarios

Esta enumeración se admite en Windows Vista y versiones posteriores.

La estructura NAPI_DOMAIN_DESCRIPTION_BLOB usa la enumeración NAPI_PROVIDER_LEVEL para especificar el nivel de autoridad de un proveedor de espacio de nombres NS_EMAIL para un dominio. Cada proveedor de espacios de nombres registrado en el espacio de nombres NS_EMAIL puede admitir varios dominios. La lista de dominios admitidos se especifica en el blob de registro del proveedor como una lista de estructuras de NAPI_DOMAIN_DESCRIPTION_BLOB . Cada especificación de dominio admitida contiene un valor de NAPI_PROVIDER_LEVEL en el miembro AuthLevel del NAPI_DOMAIN_DESCRIPTION_BLOB que describe el tipo de soporte proporcionado por el proveedor para ese dominio.

Además del dominio especificado, un proveedor de espacio de nombres de NS_EMAIL también puede registrarse como proveedor de caracteres comodín para intentar admitir cualquier dominio especificando el miembro fSupportsWildCard como distinto de cero en el NAPI_PROVIDER_INSTALLATION_BLOB pasado cuando se instala el proveedor.

Se llama a los proveedores de espacios de nombres en el siguiente orden para resolver o registrar una dirección en un dominio. Si un proveedor de espacios de nombres registrado como proveedor principal para el dominio, primero se llama a este proveedor principal. Hay dos casos en función de si se solicitan resultados autoritativos en la consulta de espacio de nombres. El valor predeterminado de una consulta es solicitar resultados autoritativos.

Cuando se solicitan resultados autoritativos en la consulta, se llama a los proveedores de espacios de nombres como se indica a continuación. Si el proveedor principal no está disponible o no puede resolver o registrar la dirección, se llama al primer proveedor secundario del catálogo winsock. Si el proveedor secundario no está disponible o no puede resolver o registrar la dirección, se llama al siguiente proveedor secundario del catálogo winsock. Si todos los proveedores secundarios no están disponibles o no pueden resolver o registrar la dirección, se llama al primer proveedor de caracteres comodín del catálogo winsock. Si el primer proveedor de caracteres comodín no está disponible o no puede resolver o registrar la dirección, se llama al siguiente proveedor de caracteres comodín en el catálogo de Winsock.

Cuando se solicitan resultados no autoritativos en la consulta, se llama a los proveedores de espacios de nombres como se indica a continuación. Se llama al proveedor principal, a todos los proveedores secundarios y a todos los proveedores de caracteres comodín y se devuelven los resultados de todas las consultas. Primero se llama al proveedor principal. Los proveedores secundarios se llaman a continuación, en función del orden del catálogo winsock. Los proveedores de caracteres comodín se llaman a continuación, según el orden en el catálogo de Winsock. Los resultados que se devuelven se basan en el orden de las consultas.

La estructura NAPI_DOMAIN_DESCRIPTION_BLOB se usa en la estructura NAPI_PROVIDER_INSTALLATION_BLOB para describir un proveedor de espacio de nombres NS_EMAIL.

Las funciones WSCInstallNameSpaceEx y WSCInstallNameSpaceEx32 se usan para instalar un proveedor de espacios de nombres para el espacio de nombres NS_EMAIL mediante una estructura de NAPI_PROVIDER_INSTALLATION_BLOB .

Las funciones WSAEnumNameSpaceProvidersEx y WSCEnumNameSpaceProvidersEx32 se usan para enumerar proveedores de espacios de nombres para el espacio de nombres NS_EMAIL y recuperar la estructura de NAPI_PROVIDER_INSTALLATION_BLOB para un proveedor.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	nsemail.h

Consulte también

NAPI_DOMAIN_DESCRIPTION_BLOB

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32