OID_WWAN_PIN
OID_WWAN_PIN define ou retorna informações relacionadas aos PINs (Números de Identificação Pessoal).
Os drivers de miniporto devem processar as solicitações de definição e consulta de forma assíncrona, retornar inicialmente NDIS_STATUS_INDICATION_REQUIRED para a solicitação original e, posteriormente, enviar um NDIS_STATUS_WWAN_PIN_INFO status notificação quando tiverem concluído o conjunto ou a solicitação de consulta.
Os drivers de miniport devem enviar NDIS_STATUS_WWAN_PIN_INFO status notificações que contêm uma estrutura NDIS_WWAN_PIN_INFO para retornar informações de estado de entrada pin e pin, principalmente para indicar se um PIN é necessário para desbloquear o dispositivo MB ou o módulo de identidade do assinante (sim cartão) ao concluir solicitações de consulta.
Os chamadores que solicitam definir informações relacionadas a PINs fornecem uma estrutura NDIS_WWAN_SET_PIN ao driver de miniporto para enviar um PIN para o dispositivo MB, habilitar ou desabilitar configurações de PIN ou alterar um PIN no SIM.
Comentários
Consulte Operações de fixação do WWAN para obter mais informações sobre como usar esse OID.
Os drivers de miniporto do Windows 7 devem usar OID_WWAN_PIN. Windows 8 miniportores devem usar OID_WWAN_PIN_EX.
Os drivers de miniport podem acessar o sim cartão (Módulo de Identidade do Assinante) ao processar operações de consulta, mas não devem acessar a rede do provedor.
Durante o processo de inicialização do driver de miniporto, o Serviço MB não prossegue para o registro até que o PIN1 seja desbloqueado com êxito, se habilitado.
Os drivers de miniporto fornecem um valor PIN, inserido pelo usuário final, no membro PinAction.Pin da estrutura NDIS_WWAN_SET_PIN ao processar solicitações definidas. Somente quando o valor do PIN corresponder ao valor armazenado no cartão sim, a solicitação deverá ser processada pelo driver de miniporte. Caso contrário, os drivers de miniporte devem falhar na solicitação definida com status WWAN_STATUS_FAILURE de código.
Os dispositivos baseados em CDMA devem relatar o bloqueio do dispositivo ligado como PIN1.
Para todos os tipos de PIN com suporte, os drivers de miniport devem dar suporte à operação WwanPinOperationEnter . Além disso, se houver suporte para PIN1, os drivers de miniport devem dar suporte às operações WwanPinOperationEnable, WwanPinOperationDisable e WwanPinOperationChange .
Se uma operação de desabilitar PIN para um tipo de PIN for tentada quando esse tipo de PIN estiver bloqueado, os drivers de miniporto poderão falhar na solicitação com WWAN_STATUS_PIN_REQUIRED ou podem concluir a solicitação com êxito. Se o driver de miniporto concluir a solicitação com êxito, a operação de desabilitação também deverá desbloquear o PIN.
Se o relatório de vários PINs estiver habilitado e apenas um PIN puder ser relatado por vez, espera-se que os drivers de miniporte relatem PIN1 primeiro. Por exemplo, se os relatórios de SubsidyLock e SIM PIN1 estiverem habilitados, o PIN do SubsidyLock deverá ser relatado (em uma solicitação de consulta subsequente) somente depois que o PIN1 tiver sido verificado com êxito.
A API MB dá suporte a outros PINs além do PIN1. No entanto, um gerenciador de conexões/GUI de terceiros precisaria ser instalado porque o Windows Gerenciador de Conexões/GUI dá suporte apenas a PIN1.
Requisitos
Versão |
Disponível no Windows 7 e versões posteriores do Windows. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |