structure WWAN_PROVIDER (wwan.h)
La structure WWAN_PROVIDER représente des détails sur un fournisseur de réseau.
Syntaxe
typedef struct _WWAN_PROVIDER {
WCHAR ProviderId[WWAN_PROVIDERID_LEN];
ULONG ProviderState;
WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
ULONG WwanDataClass;
} WWAN_PROVIDER, *PWWAN_PROVIDER;
Membres
ProviderId[WWAN_PROVIDERID_LEN]
Chaîne numérique terminée par NULL (0-9) qui représente l’identité du fournisseur de réseau.
Pour les réseaux GSM, cette chaîne est une concaténation d’un code mcc (Mobile Country Code) à trois chiffres et d’un code MNC (Mobile Network Code) à deux ou trois chiffres. Les opérateurs basés sur GSM peuvent avoir plusieurs MNC, et donc plusieurs ProviderId .
Pour les réseaux CDMA, cette chaîne est un ID système à cinq chiffres (SID). En règle générale, un transporteur basé sur CDMA a plusieurs SID. En règle générale, le transporteur a un SID pour chaque marché, qui est généralement divisé géographiquement au sein d’une nation par réglementation, comme les zones statistiques métropolitaines (MSA) aux États-Unis d’Amérique. Les pilotes miniports des appareils CDMA doivent spécifier WWAN_CDMA_DEFAULT_PROVIDER_ID si ces informations ne sont pas disponibles.
ProviderState
Valeur qui représente les différents états auxquels l’entrée du fournisseur de réseau peut être étiquetée. Le tableau suivant indique les valeurs possibles que les pilotes miniport doivent spécifier (une ou plusieurs valeurs peuvent être spécifiées).
| Valeur | Signification |
|---|---|
| WWAN_PROVIDER_STATE_HOME | Le fournisseur de réseau est l’opérateur domestique. |
| WWAN_PROVIDER_STATE_FORBIDDEN | Le fournisseur réseau figure dans la liste interdite. |
| WWAN_PROVIDER_STATE_PREFERRED | Le fournisseur de réseau figure dans la liste par défaut. |
| WWAN_PROVIDER_STATE_VISIBLE | Le fournisseur de réseau est visible. |
| WWAN_PROVIDER_STATE_REGISTERED | Le fournisseur réseau est actuellement inscrit par l’appareil. |
| WWAN_PROVIDER_STATE_UNKNOWN | L’état du fournisseur de réseau est inconnu. |
Certaines valeurs du tableau précédent s’appliquent uniquement aux identificateurs d’objet spécifiques (OID). Le tableau suivant présente les associations entre ces valeurs et les OID connexes.
| Valeur | 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]
Chaîne terminée par NULL qui représente le nom du fournisseur de réseau. Ce membre est limité à, au plus, WWAN_PROVIDERNAME_LEN caractères.
Pour les réseaux GSM, si la présentation préférée des initiales du pays et du nom de réseau mobile (PPCI&N) est supérieure à WWAN_PROVIDERNAME_LEN caractères, le pilote miniport doit abrégér le nom du réseau.
Ce membre est ignoré lorsque le service Mo définit la liste de fournisseurs par défaut.
Les pilotes miniport doivent spécifier une chaîne de NULL pour les appareils qui n’ont pas ces informations.
WwanDataClass
Bitmap qui représente la ou les classes de données que l’appareil prend en charge. Pour obtenir la liste détaillée des valeurs, consultez le membre WwanDataClass de WWAN_DEVICE_CAPS.
Ce membre peut être ignoré lorsqu’il est interrogé pour OID_WWAN_HOME_PROVIDER.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| d’en-tête | wwan.h (include Wwan.h) |