WWAN_PROVIDER struttura (wwan.h)
La struttura WWAN_PROVIDER rappresenta i dettagli relativi a un provider di rete.
Sintassi
typedef struct _WWAN_PROVIDER {
WCHAR ProviderId[WWAN_PROVIDERID_LEN];
ULONG ProviderState;
WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
ULONG WwanDataClass;
} WWAN_PROVIDER, *PWWAN_PROVIDER;
Members
ProviderId[WWAN_PROVIDERID_LEN]
Stringa numerica con terminazione NULL (0-9) che rappresenta l'identità del provider di rete.
Per le reti basate su GSM, questa stringa è una concatenazione di un codice paese mobile a tre cifre (MCC) e un codice di rete mobile a due o tre cifre (MNC). I vettori basati su GSM possono avere più di un MNC e quindi più di un ProviderId .
Per le reti basate su CDMA, questa stringa è un ID sistema a cinque cifre (SID). In genere un vettore basato su CDMA ha più di un SID. In genere, il vettore ha un SID per ogni mercato, che in genere è diviso geograficamente all'interno di una nazione in base alle normative, ad esempio Le aree statistiche metropolitane (MSA) nel Stati Uniti d'America. I driver miniport dei dispositivi basati su CDMA devono specificare WWAN_CDMA_DEFAULT_PROVIDER_ID se queste informazioni non sono disponibili.
ProviderState
Valore che rappresenta i vari stati con cui la voce del provider di rete può essere contrassegnata. La tabella seguente mostra i valori possibili che i driver miniport devono specificare (è possibile specificare uno o più valori).
| Valore | Significato |
|---|---|
| WWAN_PROVIDER_STATE_HOME | Il provider di rete è l'operatore home. |
| WWAN_PROVIDER_STATE_FORBIDDEN | Il provider di rete è presente nell'elenco non consentito. |
| WWAN_PROVIDER_STATE_PREFERRED | Il provider di rete è nell'elenco preferito. |
| WWAN_PROVIDER_STATE_VISIBLE | Il provider di rete è visibile. |
| WWAN_PROVIDER_STATE_REGISTERED | Il provider di rete è attualmente registrato dal dispositivo. |
| WWAN_PROVIDER_STATE_UNKNOWN | Lo stato del provider di rete è sconosciuto. |
Alcuni valori della tabella precedente si applicano solo agli identificatori di oggetto specifici (OID). Nella tabella seguente vengono illustrate le associazioni tra tali valori e gli ID correlati.
| Valore | OID |
|---|---|
| WWAN_PROVIDER_STATE_HOME | |
|
WWAN_PROVIDER_STATE_FORBIDDEN WWAN_PROVIDER_STATE_PREFERRED |
|
|
WWAN_PROVIDER_STATE_VISIBLE WWAN_PROVIDER_STATE_REGISTERED WWAN_PROVIDER_STATE_HOME WWAN_PROVIDER_STATE_PREFERRED WWAN_PROVIDER_STATE_FORBIDDEN |
ProviderName[WWAN_PROVIDERNAME_LEN]
Stringa con terminazione NULL che rappresenta il nome del provider di rete. Questo membro è limitato alla maggior parte dei caratteri WWAN_PROVIDERNAME_LEN.
Per le reti basate su GSM, se la presentazione preferita di Iniziali paese e Nome rete mobile (PPCI&N) è più lunga di WWAN_PROVIDERNAME_LEN caratteri, il driver miniport deve abbreviato il nome di rete.
Questo membro viene ignorato quando il servizio MB imposta l'elenco dei provider preferito.
I driver Miniport devono specificare una stringa NULL per i dispositivi che non dispongono di queste informazioni.
WwanDataClass
Bitmap che rappresenta la classe di dati (es) supportata dal dispositivo. Per un elenco dettagliato dei valori, vedere il membro WwanDataClass di WWAN_DEVICE_CAPS.
Questo membro può essere ignorato quando viene eseguita una query per OID_WWAN_HOME_PROVIDER.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| Intestazione | wwan.h (include Wwan.h) |