structure WWAN_PROVIDER (wwan.h)
La structure WWAN_PROVIDER représente des détails sur un fournisseur 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 réseau.
Pour les réseaux gsm, cette chaîne est une concaténation d’un code de pays mobile (MCC) à trois chiffres et d’un code de réseau mobile (MNC) à deux ou trois chiffres. Les opérateurs basés sur GSM peuvent avoir plusieurs MNC, et donc plusieurs ProviderId .
Pour les réseaux basés sur CDMA, cette chaîne est un ID système (SID) à cinq chiffres. En règle générale, un opérateur 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’un pays par des réglementations, telles que les zones statistiques métropolitaines (MSA) dans le États-Unis d’Amérique. Les pilotes miniport 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 avec lesquelles l’entrée du fournisseur de réseau peut être marquée. Le tableau suivant montre 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 réseau figure dans la liste par défaut. |
| WWAN_PROVIDER_STATE_VISIBLE | Le fournisseur 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 réseau est inconnu. |
Certaines valeurs du tableau précédent s’appliquent uniquement à des identificateurs d’objets spécifiques (OID). Le tableau suivant montre les associations entre ces valeurs et les OID associés.
| 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é à WWAN_PROVIDERNAME_LEN caractères au maximum.
Pour les réseaux GSM, si la présentation préférée des initiales de pays et du nom de réseau mobile (PPCI&N) est plus longue que WWAN_PROVIDERNAME_LEN caractères, le pilote miniport doit abréger le nom du réseau.
Ce membre est ignoré lorsque le service Mo définit la liste des fournisseurs préférés.
Les pilotes miniport doivent spécifier une chaîne NULL pour les appareils qui ne disposent pas de 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| En-tête | wwan.h (inclure Wwan.h) |