Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
OID_WWAN_PROVISIONED_CONTEXTS lê ou atualiza as entradas de contexto provisionadas armazenadas no dispositivo MB ou no SIM (Módulo de Identidade do Assinante).
Os drivers de miniport devem processar solicitações de definição e consulta de forma assíncrona, retornando inicialmente NDIS_STATUS_INDICATION_REQUIRED à solicitação original e, posteriormente, enviando uma notificação de status NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS contendo uma estrutura NDIS_WWAN_PROVISIONED_CONTEXTS para fornecer informações sobre entradas de contexto provisionadas armazenadas no dispositivo MB ou no SIM (Módulo de Identidade do Assinante), independentemente de concluir solicitações de conjunto ou consulta.
Observações
Para obter mais informações sobre como usar essa OID, consulte de Gerenciamento de Contexto de Pacote WWAN.
Os drivers de miniporto deverão retornar NDIS_STATUS_NOT_SUPPORTED se o dispositivo MB compatível não oferecer suporte à recuperação de contextos provisionados.
Os dispositivos baseados em GSM podem, opcionalmente, dar suporte a operações de consulta e de definição. Os dispositivos baseados em CDMA podem, opcionalmente, dar suporte a operações de consulta relatando IP simples (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP).
As entradas de contexto provisionadas armazenadas no dispositivo MB ou no SIM são locais para o dispositivo. Os drivers de miniporto não devem se conectar à rede para serem lidos nesses campos.
A estrutura de entrada de uma solicitação definida é NDIS_WWAN_SET_PROVISIONED_CONTEXT e a indicação de status desse objeto é NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS.
Os contextos provisionados não são iguais aos das definições de contexto gprs no 3GPP que armazenam em cache a lista de APNs. Os contextos provisionados são os parâmetros de conectividade (AccessString, UserName e Password) que são pré-provisionados pelos Operadores ou OTA provisionados pelo dispositivo e podem ser armazenados na memória do dispositivo ou no SIM. Os parâmetros de conectividade retornados pelos contextos provisionados serão usados pelo Serviço MB para ativação PDP.
A consulta e a forma definida desse objeto são usadas.
O processamento dessa solicitação não requer acesso à rede, mas requer acesso ao SIM ou à memória auxiliar no dispositivo MB.
O driver de miniporto envia NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS notificação ao sistema operacional. O membro ContextListHeader.ElementType deve ser definido como WwanStructContext . O driver miniport deve definir o membro ContextListHeader.ElementCount 0 quando a notificação for enviada em resposta a uma solicitação definida.
O Serviço MB deve recuperar a lista de contextos provisionados do dispositivo antes de realizar qualquer ativação ou desativação de contexto individual. A lista de contextos provisionados deve ser restrita apenas à rede do provedor doméstico, embora o dispositivo possa ter a capacidade de armazenar vários contextos de provedor de rede. A lista de contexto sempre deve ser a rede do provedor inicial específica mesmo em caso de roaming.
A operação set OID_WWAN_PROVISIONED_CONTEXT deve associar o contexto ao provedor de rede especificado na solicitação definida em ProviderId membro da estrutura WWAN_SET_CONTEXT. O contexto provisionado armazenado por meio do conjunto OID_WWAN_PROVISIONED_CONTEXT solicitações deve persistir entre as reinicializações do sistema e os ciclos de energia do dispositivo.
Todos os contextos vazios precisam ser relatados em uma consulta, juntamente com os contextos provisionados aplicáveis à rede do provedor doméstico.
Dispositivos CDMA configurados para SimpleIP, relatórios em WWAN_CTRL_CAPS_CDMA_SIMPLE_IP no WwanControlCaps podem, opcionalmente, retornar pelo menos um contexto provisionado preenchido com os membros corretos AccessString, UserNamee Password membros para a solicitação de consulta do Serviço MB.
A lista de contexto provisionada deve ser pré-provisionada no dispositivo, atualizada por conjunto OID_WWAN_PROVISIONED_CONTEXT operações ou atualizada por dispositivo/operador usando SMS ou OTA. Ele não deve ser atualizado dinamicamente com base nas informações de contexto fornecidas na operação de OID_WWAN_CONNECT pelo Serviço MB.
Para obter mais informações sobre como acessar AccessString, UserName e Password do dispositivo MB para cada contexto provisionado na lista, consulte WWAN_CONTEXT.
Requisitos
Versão |
Disponível no Windows 7 e versões posteriores do Windows. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |