estructura de NAPI_PROVIDER_INSTALLATION_BLOB (nsemail.h)

Artículo
08/25/2023

La estructura NAPI_PROVIDER_INSTALLATION_BLOB contiene la información necesaria para instalar un proveedor de espacios de nombres para el espacio de nombres NS_EMAIL.

Sintaxis

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

Miembros

dwVersion

Tipo: DWORD

Número de versión del proveedor de espacio de nombres NS_EMAIL. Este miembro es específico del proveedor de espacios de nombres.

dwProviderType

Tipo: DWORD

Tipo de proveedor de espacio de nombres para el espacio de nombres NS_EMAIL. Este miembro puede ser uno de los valores del tipo de enumeración NAPI_PROVIDER_TYPE definido en el archivo de encabezado Nsemail.h .

fSupportsWildCard

Tipo: DWORD

Valor booleano que indica si este proveedor de espacio de nombres de NS_EMAIL admite nombres comodín. Si este miembro no es cero, un proveedor de NS_EMAIL reclama que pueda resolver o registrar cualquier nombre que no pertenezca a ningún dominio, el proveedor esté registrado específicamente para como principal o secundario. Si este miembro no es cero, se puede llamar al proveedor de NS_EMAIL para resolver o registrar cualquier dirección, si no hay ningún proveedor principal o secundario para el dominio disponible.

Puede haber varios proveedores que notificaciones puedan resolver cualquier dirección ( fSupportsWildCard establecido en distinto de cero). Si hay proveedores de espacios de nombres con este valor que también se registran como proveedor de caracteres comodín, se llama a los proveedores en el orden en que aparecen en el catálogo de espacios de nombres winsock.

cDomains

Tipo: DWORD

El número de NAPI_DOMAIN_DESCRIPTION_BLOB estructura el inicio en el miembro OffsetFirstDomain usado para describir los dominios admitidos por este proveedor de espacios de nombres NS_EMAIL.

OffsetFirstDomain

Tipo: DWORD

Desplazamiento, en bytes, a la primera de varias estructuras de NAPI_DOMAIN_DESCRIPTION_BLOB usadas para describir los dominios admitidos por este proveedor de espacio de nombres NS_EMAIL. Este desplazamiento debe alinearse en un mínimo de un límite de cuatro bytes.

Comentarios

Esta estructura se admite en Windows Vista y versiones posteriores.

La estructura NAPI_PROVIDER_INSTALLATION_BLOB contiene la información necesaria para instalar un proveedor de espacios de nombres para el espacio de nombres NS_EMAIL. Puede haber varios proveedores de espacios de nombres para la instalación del espacio de nombres NS_EMAIL en un sistema local.

Cada proveedor de espacios de nombres registrado en el espacio de nombres NS_EMAIL puede admitir varios dominios. Como resultado, puede haber varias estructuras de NAPI_DOMAIN_DESCRIPTION_BLOB en la estructura de NAPI_PROVIDER_INSTALLATION_BLOB para un proveedor de espacio de nombres NS_EMAIL. 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 nivel de autoridad proporcionado por el proveedor para ese dominio.

Los proveedores de espacios de nombres se llaman 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 de 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 de 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 de 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 en el catálogo de Winsock. Los proveedores de caracteres comodín se llaman a continuación, en función del orden en el catálogo de Winsock. Los resultados devueltos se basan en el orden de las consultas.

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 todos los proveedores de espacios de nombres (incluidos los proveedores de espacios de nombres NS_EMAIL) y recuperar la estructura de NAPI_PROVIDER_INSTALLATION_BLOB para un proveedor si el proveedor registró un blob tras la instalación.

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