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) no Estados Unidos da América. Os drivers de miniporte 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 os OIDs 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]
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 miniporte deverá abreviar o nome da rede.
Esse membro é ignorado quando o Serviço MB define a lista de provedores preferenciais.
Os drivers de miniport devem especificar uma cadeia de caracteres NULL para dispositivos que não têm essas informações.
WwanDataClass
Um bitmap que representa as classes de dados compatíveis com o dispositivo. Para obter uma lista detalhada de valores, consulte o membro WwanDataClass do WWAN_DEVICE_CAPS.
Esse membro pode ser ignorado quando consultado para OID_WWAN_HOME_PROVIDER.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 7 e versões posteriores do Windows. |
| Cabeçalho | wwan.h (inclua Wwan.h) |