struttura NAPI_PROVIDER_INSTALLATION_BLOB (nsemail.h)
La struttura NAPI_PROVIDER_INSTALLATION_BLOB contiene le informazioni necessarie per installare un provider di spazi dei nomi per lo spazio dei nomi NS_EMAIL.
Sintassi
typedef struct napi_provider_installation_blob_tag {
DWORD dwVersion;
DWORD dwProviderType;
DWORD fSupportsWildCard;
ULONG cDomains;
ULONG OffsetFirstDomain;
} NAPI_PROVIDER_INSTALLATION_BLOB;
Members
dwVersion
Tipo: DWORD
Numero di versione del provider dello spazio dei nomi NS_EMAIL. Questo membro è specifico del provider dello spazio dei nomi.
dwProviderType
Tipo: DWORD
Tipo di provider dello spazio dei nomi per lo spazio dei nomi NS_EMAIL. Questo membro può essere uno dei valori del tipo di enumerazione NAPI_PROVIDER_TYPE definito nel file di intestazione Nsemail.h .
fSupportsWildCard
Tipo: DWORD
Valore booleano che indica se questo provider di spazi dei nomi NS_EMAIL supporta i nomi con caratteri jolly. Se questo membro è diverso da zero, un provider di NS_EMAIL dichiara di essere potenzialmente in grado di risolvere o registrare qualsiasi nome che non appartiene ad alcun dominio il provider viene registrato specificamente per come primario o secondario. Se questo membro è diverso da zero, il provider di NS_EMAIL può essere chiamato per risolvere o registrare qualsiasi indirizzo, se non è disponibile alcun provider primario o secondario per il dominio.
Potrebbero essere presenti più provider che sostengono di essere in grado di risolvere qualsiasi indirizzo ( fSupportsWildCard impostato su diverso da zero). Se sono presenti provider di spazi dei nomi con questo valore registrati anche come provider con caratteri jolly, i provider vengono chiamati nell'ordine in cui vengono visualizzati nel catalogo degli spazi dei nomi Winsock.
cDomains
Tipo: DWORD
Numero di NAPI_DOMAIN_DESCRIPTION_BLOB strutture a partire dal membro OffsetFirstDomain usato per descrivere i domini supportati da questo provider dello spazio dei nomi NS_EMAIL.
OffsetFirstDomain
Tipo: DWORD
Offset, in byte, al primo di più strutture NAPI_DOMAIN_DESCRIPTION_BLOB utilizzate per descrivere i domini supportati da questo provider di spazi dei nomi NS_EMAIL. Questo offset deve essere allineato su un limite minimo di quattro byte.
Commenti
Questa struttura è supportata in Windows Vista e versioni successive.
La struttura NAPI_PROVIDER_INSTALLATION_BLOB contiene le informazioni necessarie per installare un provider di spazi dei nomi per lo spazio dei nomi NS_EMAIL. È possibile che siano presenti più provider di spazi dei nomi per l'installazione dello spazio dei nomi NS_EMAIL in un sistema locale.
Ogni provider di spazi dei nomi registrato nello spazio dei nomi NS_EMAIL può supportare più domini. Di conseguenza, potrebbero essere presenti più strutture NAPI_DOMAIN_DESCRIPTION_BLOB nella struttura NAPI_PROVIDER_INSTALLATION_BLOB per un provider di spazi dei nomi NS_EMAIL. L'elenco dei domini supportati viene specificato nel BLOB di registrazione del provider come elenco di strutture NAPI_DOMAIN_DESCRIPTION_BLOB . Ogni specifica di dominio supportata contiene un valore NAPI_PROVIDER_LEVEL nel membro AuthLevel del NAPI_DOMAIN_DESCRIPTION_BLOB che descrive il livello di autorità fornito dal provider per tale dominio.
I provider di spazi dei nomi vengono chiamati nell'ordine seguente per risolvere o registrare un indirizzo in un dominio. Se un provider dello spazio dei nomi registrato come provider primario per il dominio, questo provider primario viene chiamato per primo. Esistono due casi a seconda che nella query dello spazio dei nomi vengano richiesti risultati autorevoli. L'impostazione predefinita per una query consiste nel richiedere risultati autorevoli.
Quando nella query vengono richiesti risultati autorevoli, i provider di spazi dei nomi vengono chiamati come indicato di seguito. Se il provider primario non è disponibile o non è in grado di risolvere o registrare l'indirizzo, viene chiamato il primo provider secondario nel catalogo Winsock. Se il provider secondario non è disponibile o non è in grado di risolvere o registrare l'indirizzo, viene chiamato il provider secondario successivo nel catalogo Winsock. Se tutti i provider secondari non sono disponibili o non sono in grado di risolvere o registrare l'indirizzo, viene chiamato il primo provider con caratteri jolly nel catalogo Winsock. Se il primo provider con caratteri jolly non è disponibile o non è in grado di risolvere o registrare l'indirizzo, viene chiamato il provider con caratteri jolly successivo nel catalogo Winsock.
Quando nella query vengono richiesti risultati non autorevoli, i provider di spazi dei nomi vengono chiamati come segue. Il provider primario, tutti i provider secondari e tutti i provider con caratteri jolly vengono chiamati e vengono restituiti i risultati di tutte le query. Il provider primario viene chiamato per primo. I provider secondari vengono chiamati next, in base all'ordine nel catalogo Winsock. I provider con caratteri jolly vengono chiamati next, in base all'ordine nel catalogo Winsock. I risultati restituiti sono basati sull'ordine delle query.
Le funzioni WSCInstallNameSpaceEx e WSCInstallNameSpaceEx32 vengono usate per installare un provider di spazi dei nomi per lo spazio dei nomi NS_EMAIL utilizzando una struttura NAPI_PROVIDER_INSTALLATION_BLOB .
Le funzioni WSAEnumNameSpaceProvidersEx e WSCEnumNameSpaceProvidersEx32 vengono usate per enumerare tutti i provider di spazi dei nomi (inclusi i provider di spazi dei nomi NS_EMAIL) e recuperare la struttura NAPI_PROVIDER_INSTALLATION_BLOB per un provider se il provider ha registrato un BLOB al momento dell'installazione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | nsemail.h |