estrutura WWAN_PROVIDER (wwan.h)

  • Artigo

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

OID_WWAN_HOME_PROVIDER
WWAN_PROVIDER_STATE_FORBIDDEN

WWAN_PROVIDER_STATE_PREFERRED

OID_WWAN_PREFERRED_PROVIDERS
WWAN_PROVIDER_STATE_VISIBLE

WWAN_PROVIDER_STATE_REGISTERED

WWAN_PROVIDER_STATE_HOME

WWAN_PROVIDER_STATE_PREFERRED

WWAN_PROVIDER_STATE_FORBIDDEN

OID_WWAN_VISIBLE_PROVIDERS

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)

Confira também

NDIS_WWAN_HOME_PROVIDER

NDIS_WWAN_PREFERRED_PROVIDERS

NDIS_WWAN_VISIBLE_PROVIDERS

WWAN_DEVICE_CAPS