enumerazione NAPI_PROVIDER_LEVEL (nsemail.h)
L'enumerazione NAPI_PROVIDER_LEVEL specifica il livello di autorità del provider di un provider di spazi dei nomi NS_EMAIL per un determinato dominio.
Sintassi
typedef enum napi_provider_level_tag {
ProviderLevel_None = 0,
ProviderLevel_Secondary,
ProviderLevel_Primary
} NAPI_PROVIDER_LEVEL;
Costanti
ProviderLevel_NoneValore: 0 Il provider di spazi dei nomi non supporta il dominio corrente. Questo valore può essere usato per disattivare temporaneamente il supporto per un dominio senza rimuoverlo dall'elenco dei domini supportati. Se ProviderLevel_None è impostato nel membro AuthLevel del NAPI_DOMAIN_DESCRIPTION_BLOB per un determinato dominio quando il provider è installato e registrato, il provider dello spazio dei nomi non verrà chiamato per risolvere o registrare un indirizzo in tale dominio, a meno che il provider non sia registrato come provider con caratteri jolly. È possibile che siano presenti più provider di spazi dei nomi NS_EMAIL per un dominio con un valore di ProviderLevel_None. Se sono presenti provider di spazi dei nomi con questo valore che è stato registrato anche come provider con caratteri jolly, i provider vengono chiamati nell'ordine in cui vengono visualizzati nel catalogo Winsock. |
ProviderLevel_SecondaryIl provider dello spazio dei nomi è un provider secondario per un dominio nello spazio dei nomi NS_EMAIL. Un provider di spazi dei nomi può essere un provider secondario nel dominio di destinazione se il provider può risolvere e registrare i nomi NS_EMAIL per questo dominio e dare la stessa risposta che un provider primario fornirebbe. Se ProviderLevel_Secondary è impostato nel membro AuthLevel del NAPI_DOMAIN_DESCRIPTION_BLOB per un determinato dominio quando il provider è installato e registrato, questo provider viene chiamato quando un provider primario per il dominio non è attualmente disponibile o il provider primario non è in grado di risolvere o registrare l'indirizzo in tale dominio. È possibile che siano presenti più provider di spazi dei nomi secondari NS_EMAIL per un dominio con un valore di ProviderLevel_Secondary. Se sono presenti più provider di spazi dei nomi secondari, i provider vengono chiamati nell'ordine in cui vengono visualizzati nel catalogo Winsock. |
ProviderLevel_PrimaryIl provider dello spazio dei nomi è il provider primario per un dominio nello spazio dei nomi NS_EMAIL. Un provider di spazi dei nomi può dichiarare di essere il provider primario per un dominio se possiede tutti i nomi di NS_EMAIL per tale dominio e quindi ha accesso ai dati master per tutti questi nomi. È necessario che nel sistema locale sia presente solo un singolo provider di spazi dei nomi primario NS_EMAIL per un dominio registrato. Nota Non devono mai essere presenti due provider di spazi dei nomi NS_EMAIL che dichiarano di essere il provider primario per lo stesso dominio. Se più provider tentano di registrare come provider primario per lo stesso dominio, verrà chiamato il primo provider trovato nel catalogo dello spazio dei nomi Winsock per il dominio come provider primario. Tutte le altre attestazioni del provider che devono essere il provider primario vengono ignorate. |
Commenti
Questa enumerazione è supportata in Windows Vista e versioni successive.
L'enumerazione NAPI_PROVIDER_LEVEL viene usata dalla struttura NAPI_DOMAIN_DESCRIPTION_BLOB per specificare il livello di autorità di un provider di spazi dei nomi NS_EMAIL per un dominio. Ogni provider di spazi dei nomi registrato nello spazio dei nomi NS_EMAIL può supportare più domini. 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 tipo di supporto fornito dal provider per tale dominio.
Oltre al dominio specificato, un provider di spazi dei nomi NS_EMAIL può anche registrarsi come provider con caratteri jolly per provare e supportare qualsiasi dominio, specificando il membro fSupportsWildCard come non zero nella NAPI_PROVIDER_INSTALLATION_BLOB passato quando il provider viene installato.
I provider di spazi dei nomi vengono chiamati nell'ordine seguente per risolvere o registrare un indirizzo in un dominio. Se un provider di spazi dei nomi registrato come provider primario per il dominio, questo provider primario viene chiamato prima. Esistono due casi a seconda che vengano richiesti risultati autorevoli nella query dello spazio dei nomi. Il valore predefinito per una query consiste nel richiedere risultati autorevoli.
Quando vengono richiesti risultati autorevoli nella query, 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 jolly successivo nel catalogo Winsock.
Quando nella query vengono richiesti risultati non autorevoli, i provider di spazi dei nomi vengono chiamati come indicato di seguito. Il provider primario, tutti i provider secondari e tutti i provider con caratteri jolly vengono chiamati e i risultati di tutte le query vengono restituiti. Il provider primario viene chiamato prima. I provider secondari vengono chiamati successivamente, in base all'ordine nel catalogo Winsock. I provider con caratteri jolly vengono chiamati successivamente, in base all'ordine nel catalogo Winsock. I risultati restituiti sono basati sull'ordine delle query.
La struttura NAPI_DOMAIN_DESCRIPTION_BLOB viene usata nella struttura NAPI_PROVIDER_INSTALLATION_BLOB per descrivere un provider di spazi dei nomi NS_EMAIL .
Le funzioni WSCInstallNameSpaceEx e WSCInstallNameSpaceEx32 vengono usate per installare un provider di spazi dei nomi per lo spazio dei nomi NS_EMAIL usando una struttura NAPI_PROVIDER_INSTALLATION_BLOB.
Le funzioni WSAEnumNameSpaceProvidersEx e WSCEnumNameSpaceProvidersEx32 vengono usate per enumerare i provider di spazi dei nomi per lo spazio dei nomi NS_EMAIL e recuperare la struttura NAPI_PROVIDER_INSTALLATION_BLOB per un provider.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | nsemail.h |