estrutura WWAN_PROVIDER (wwan.h)
A estrutura WWAN_PROVIDER representa detalhes sobre um provedor de rede.
Sintaxe
typedef struct _WWAN_PROVIDER {
WCHAR ProviderId[WWAN_PROVIDERID_LEN];
ULONG ProviderState;
WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
ULONG WwanDataClass;
} WWAN_PROVIDER, *PWWAN_PROVIDER;
Membros
ProviderId[WWAN_PROVIDERID_LEN]
Uma cadeia de caracteres numérica terminada em NULL (0-9) que representa a identidade do provedor de rede.
Para redes baseadas em GSM, essa cadeia de caracteres é uma concatenação de um MCC (Mobile Country Code) de três dígitos e um MNC (Código de Rede Móvel) de dois ou três dígitos. As operadoras baseadas em GSM podem ter mais de um MNC e, portanto, mais de um ProviderId .
Para redes baseadas em CDMA, essa cadeia de caracteres é uma SID (ID do Sistema) de cinco dígitos. Geralmente, uma operadora baseada em CDMA tem mais de um SID. Normalmente, a transportadora tem um SID para cada mercado, que geralmente é dividido geograficamente dentro de uma nação por regulamentos, como áreas estatísticas metropolitanas (MSA) nos Estados Unidos da América. Os drivers de miniport de dispositivos baseados em CDMA devem especificar WWAN_CDMA_DEFAULT_PROVIDER_ID se essas informações não estiverem disponíveis.
ProviderState
Um valor que representa os vários estados com os quais a entrada do provedor de rede pode ser marcada. A tabela a seguir mostra os valores possíveis que os drivers de miniporto devem especificar (um ou mais valores podem ser especificados).
| Valor | Significado |
|---|---|
| WWAN_PROVIDER_STATE_HOME | O provedor de rede é o operador inicial. |
| WWAN_PROVIDER_STATE_FORBIDDEN | O provedor de rede está na lista proibida. |
| WWAN_PROVIDER_STATE_PREFERRED | O provedor de rede está na lista preferencial. |
| WWAN_PROVIDER_STATE_VISIBLE | O provedor de rede está visível. |
| WWAN_PROVIDER_STATE_REGISTERED | O provedor de rede está registrado no momento pelo dispositivo. |
| WWAN_PROVIDER_STATE_UNKNOWN | O estado do provedor de rede é desconhecido. |
Alguns valores na tabela anterior se aplicam apenas a identificadores de objeto específicos (OIDs). A tabela a seguir mostra as associações entre esses valores e OIDs relacionadas.
| 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]
Uma cadeia de caracteres terminada em NULL que representa o nome do provedor de rede. Esse membro é limitado a, no máximo, WWAN_PROVIDERNAME_LEN caracteres.
Para redes baseadas em GSM, se a apresentação preferencial de iniciais de país e nome de rede móvel (PPCI&N) for maior que WWAN_PROVIDERNAME_LEN caracteres, o driver de miniporto deverá abreviar o nome da rede.
Esse membro é ignorado quando o Serviço MB define a lista de provedores preferenciais.
Os drivers de miniporto devem especificar uma cadeia de caracteres NULL para dispositivos que não têm essas informações.
WwanDataClass
Um bitmap que representa a classe de dados que o dispositivo dá suporte. Para obter uma lista detalhada de valores, consulte o WwanDataClass membro do WWAN_DEVICE_CAPS.
Esse membro pode ser ignorado quando consultado para OID_WWAN_HOME_PROVIDER.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 7 e versões posteriores do Windows. |
| cabeçalho | wwan.h (inclua Wwan.h) |