NAPI_DOMAIN_DESCRIPTION_BLOB structure (nsemail.h)

The NAPI_DOMAIN_DESCRIPTION_BLOB structure describes a ___domain handled by a namespace provider for the NS_EMAIL namespace.

Syntax

typedef struct napi_domain_description_blob_tag {
  DWORD AuthLevel;
  DWORD cchDomainName;
  DWORD OffsetNextDomainDescription;
  DWORD OffsetThisDomainName;
} NAPI_DOMAIN_DESCRIPTION_BLOB;

Members

AuthLevel

The authority level of the namespace provider for this ___domain. This member can be one of the values from the NAPI_PROVIDER_LEVEL enumeration type defined in the Nsemail.h header file.

cchDomainName

The length, in Unicode characters, of the Unicode string that contains the ___domain name represented by the OffsetThisDomainName member. The NULL terminator is not counted when calculating the length.

OffsetNextDomainDescription

The offset, in bytes, to the next NAPI_DOMAIN_DESCRIPTION_BLOB structure in the NAPI_PROVIDER_INSTALLATION_BLOB structure.

OffsetThisDomainName

The offset, in bytes, to a Unicode string that contains a ___domain name handled by this namespace provider for the NS_EMAIL namespace. The ___domain name must be at least cchDomainName Unicode characters in length. NULL-termination of the Unicode string that contains the ___domain name is recommended, but not required. This offset must be aligned on a minimum of a two-byte boundary.

Remarks

This structure is supported on Windows Vista and later.

The NAPI_DOMAIN_DESCRIPTION_BLOB structure describes a ___domain handled by a namespace provider for the NS_EMAIL namespace. A typical ___domain name represented by the OffsetThisDomainName member in this structure might be msn.com or yahoo.com.

Each namespace provider registered in the NS_EMAIL namespace can support multiple domains. The list of supported domains is specified in the provider registration blob as a list of NAPI_DOMAIN_DESCRIPTION_BLOB structures. Each supported ___domain specification contains a NAPI_PROVIDER_LEVEL value in the AuthLevel member of the NAPI_DOMAIN_DESCRIPTION_BLOB that describes the type of support provided by the provider for that ___domain.

The NAPI_DOMAIN_DESCRIPTION_BLOB structure is a member of the NAPI_PROVIDER_INSTALLATION_BLOB structure used to describe and register a NS_EMAIL namespace provider. There may be multiple NAPI_DOMAIN_DESCRIPTION_BLOB structures in the NAPI_PROVIDER_INSTALLATION_BLOB structure for an NS_EMAIL namespace provider.

The WSCInstallNameSpaceEx and WSCInstallNameSpaceEx32 functions are used to install a namespace provider for the NS_EMAIL namespace using a NAPI_PROVIDER_INSTALLATION_BLOB structure.

The WSAEnumNameSpaceProvidersEx and WSCEnumNameSpaceProvidersEx32 functions are used to enumerate all namespace providers (including NS_EMAIL namespace providers) and to retrieve the NAPI_PROVIDER_INSTALLATION_BLOB structure for a provider if the provider registered a blob upon installation.

Requirements

See also

NAPI_PROVIDER_INSTALLATION_BLOB

NAPI_PROVIDER_LEVEL

WSAEnumNameSpaceProvidersEx

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32