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 tanto, más de un proveedor de providerId .
Para las redes basadas en CDMA, esta cadena es un identificador del sistema de cinco dígitos (SID). Por lo general, un operador basado en CDMA 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 los Estados Unidos de América. Los controladores de miniporte de dispositivos basados en CDMA 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 miniport (se pueden especificar uno o varios 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 dispositivo registra actualmente el proveedor de red. |
| 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.
Para las redes basadas en GSM, si la presentación preferida de iniciales de país y nombre de red móvil (PPCI&N) es más larga que WWAN_PROVIDERNAME_LEN caracteres, el controlador de miniport debe abreviar el nombre de red.
Este miembro se omite cuando el servicio MB establece la lista de proveedores preferidos.
Los controladores de miniport deben especificar un cadena NULL para los dispositivos que no tienen esta información.
WwanDataClass
Mapa de bits que representa las clases de datos que admite el dispositivo. Para obtener una lista detallada de valores, consulte el miembro WwanDataClass de WWAN_DEVICE_CAPS.
Este miembro se puede omitir cuando se consulta para OID_WWAN_HOME_PROVIDER.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 7 y versiones posteriores de Windows. |
| encabezado de | wwan.h (incluya Wwan.h) |