estructura WWAN_PROVIDER (wwan.h)
La estructura WWAN_PROVIDER representa detalles sobre un proveedor de red.
Sintaxis
typedef struct _WWAN_PROVIDER {
WCHAR ProviderId[WWAN_PROVIDERID_LEN];
ULONG ProviderState;
WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
ULONG WwanDataClass;
} WWAN_PROVIDER, *PWWAN_PROVIDER;
Miembros
ProviderId[WWAN_PROVIDERID_LEN]
Cadena numérica terminada en NULL (0-9) que representa la identidad del proveedor de red.
Para las redes basadas en GSM, esta cadena es una concatenación de un código de país móvil de tres dígitos (MCC) y un código de red móvil de dos o tres dígitos (MNC). Los operadores basados en GSM pueden tener más de un MNC y, por lo tanto, más de un ProviderId .
En el caso de las redes basadas en XAML, esta cadena es un identificador del sistema de cinco dígitos (SID). Por lo general, un transportista basado en SILENCIOSA tiene más de un SID. Normalmente, el transportista tiene un SID para cada mercado, que normalmente se divide geográficamente dentro de una nación por normativas, como áreas estadísticas metropolitanas (MSA) en la Estados Unidos de América. Los controladores de miniporte de dispositivos basados en FRAMEWORK deben especificar WWAN_CDMA_DEFAULT_PROVIDER_ID si esta información no está disponible.
ProviderState
Valor que representa los distintos estados con los que se puede etiquetar la entrada del proveedor de red. En la tabla siguiente se muestran los valores posibles que deben especificar los controladores de minipuerto (se pueden especificar uno o más valores).
| Valor | Significado |
|---|---|
| WWAN_PROVIDER_STATE_HOME | El proveedor de red es el operador principal. |
| WWAN_PROVIDER_STATE_FORBIDDEN | El proveedor de red está en la lista prohibida. |
| WWAN_PROVIDER_STATE_PREFERRED | El proveedor de red está en la lista preferida. |
| WWAN_PROVIDER_STATE_VISIBLE | El proveedor de red está visible. |
| WWAN_PROVIDER_STATE_REGISTERED | El proveedor de red está registrado actualmente por el dispositivo. |
| WWAN_PROVIDER_STATE_UNKNOWN | El estado del proveedor de red es desconocido. |
Algunos valores de la tabla anterior solo se aplican a identificadores de objeto específicos (OID). En la tabla siguiente se muestran las asociaciones entre esos valores y los OID relacionados.
| Valor | 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]
Cadena terminada en NULL que representa el nombre del proveedor de red. Este miembro está limitado a, como máximo, WWAN_PROVIDERNAME_LEN caracteres.
En el caso de las redes basadas en GSM, si la presentación preferida de iniciales de país y nombre de red móvil (PPCI&N) es mayor que WWAN_PROVIDERNAME_LEN caracteres, el controlador de minipuerto debe abreviar el nombre de red.
Este miembro se omite cuando el servicio MB establece la lista de proveedores preferidos.
Los controladores de minipuerto deben especificar una cadena NULL para los dispositivos que no tengan esta información.
WwanDataClass
Mapa de bits que representa las clases de datos que admite el dispositivo. Para obtener una lista detallada de valores, vea el miembro WwanDataClass de WWAN_DEVICE_CAPS.
Este miembro se puede omitir cuando se consulta para OID_WWAN_HOME_PROVIDER.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 7 y versiones posteriores de Windows. |
| Encabezado | wwan.h (incluye Wwan.h) |