Compartilhar via

Visão geral das APIs de Windows Runtime de banda larga móvel

  • Artigo

A tabela a seguir lista as APIs para criar um aplicativo de banda larga móvel.

API Descrição

API de Perfil de Conexão

Fornece informações sobre a status de conexão (por exemplo, com a Internet)

API de Extensão dos Serviços de Dispositivo

Habilita extensões específicas do dispositivo, como o KIT de Ferramentas sim e o download da PRL (Lista de Roaming Preferencial).

API de provisionamento

Permite provisionar o Windows com dados de provisionamento de conta e informações de uso de dados.

SIM PIN API

Permite habilitar, desabilitar ou alterar o PIN do SIM.

SMS API

Fornece funções necessárias para implementar um cliente SMS.

API de Informações do Assinante e do Dispositivo

Fornece informações do assinante para o SIM e as informações do dispositivo para o dispositivo de banda larga móvel.

USSD API

Permite que você estabeleça uma sessão de USSD (Dados de Serviço Suplementar Não Estruturados) com uma rede (cliente e rede iniciada).

As seções a seguir estão disponíveis neste tópico:

API de Conta de Banda Larga Móvel

Como ele tem métodos que podem ser usados para obter informações de identificação pessoal sobre o cliente e alterar as configurações de rede em dispositivos de banda larga móvel, a API de Conta de Banda Larga Móvel é uma API privilegiada. Isso significa que a maioria dos aplicativos UWP não pode chamar seus métodos sem obter um erro de "acesso negado". Para poder chamar essa API, um aplicativo UWP deve atender aos seguintes critérios:

  • O aplicativo deve ter um pacote de metadados de dispositivo ou de metadados de serviço associado a ele e deve ser listado no elemento XML PrivilegedApplications do arquivo SoftwareInfo.xml dentro do pacote. O pacote não precisa ser exclusivo para o aplicativo; É possível que qualquer aplicativo UWP específico seja listado no elemento PrivilegedApplications de vários pacotes. Esse pacote deve ser associado ao provedor de serviços para um dispositivo de banda larga móvel que tenha sido ativo pelo menos uma vez no computador, para que ele tenha sido instalado.

  • O arquivo appxmanifest do aplicativo precisa de uma <entrada DeviceCapability> para a API de Conta de Banda Larga Móvel. Você pode fazer isso adicionando o seguinte elemento XML como um filho do <elemento Capabilities> no arquivo appxmanifest do aplicativo:

    <DeviceCapability Name="BFCD56F7-3943-457F-A312-2E19BB6DC648" />

    Para obter mais informações sobre o <elemento Capabilities>, consulte Arquivo de manifesto do aplicativo para Windows 8.

Nota Aplicativos que não são aplicativos UWP (por exemplo, serviços ou aplicativos de área de trabalho do Microsoft Win32) têm acesso irrestrito à API da Conta de Banda Larga Móvel. Isso ocorre porque esses aplicativos podem usar APIs existentes do Win32 e do COM (Component Object Model) para obter acesso total à rede de banda larga móvel. Essas APIs não podem ser usadas de aplicativos UWP.

IDs de conta de rede

Uma ID de conta de rede é um identificador exclusivo para uma conta de banda larga móvel. Ele fornece uma ID unificada que pode ser usada sem precisar saber se a ID vem de uma rede GSM, CDMA ou WiMAX. O Windows gera IDs de conta de rede sempre que encontra um identificador de assinatura de rede fornecido por hardware que ele não encontrou antes. A lista a seguir identifica a ID da conta de rede para cada tipo de rede com suporte:

  • Redes GSM: o ICCID do SIM é usado para diferenciar entre assinaturas.

  • Redes CDMA: o MIN (número de identificação móvel) é usado.

Quando o Windows encontra um dos tipos de rede anteriores pela primeira vez, ele cria uma nova ID de conta de rede e a mapeia para um hash SHA-256 do identificador de assinatura fornecido por hardware e armazena ambos no registro. Por outro lado, se o Windows encontrar o hash do identificador de assinatura fornecido por hardware no registro, ele usará a ID da conta de rede associada a esse hash. As IDs da conta de rede devem ser globalmente exclusivas (elas são baseadas em GUIDs), mas como o que é armazenado é um hash do identificador fornecido por hardware, o hardware de rede deve estar presente ao tentar mapear uma ID de conta de rede de volta para o ICCID ou MIN do qual foi gerado.

Importante Embora obter o ICCID de uma ID de conta de rede exija acesso ao computador e ao dispositivo de rede que são usados para mapeá-los juntos, as IDs da conta de rede identificam exclusivamente usuários individuais. Portanto, recomendamos que você siga as políticas da sua organização para lidar com informações de identificação pessoal quando estiver trabalhando com elas.

As IDs de conta de rede são segregadas pela operadora de rede móvel (MNO), de modo que, se um usuário final tiver dispositivos de banda larga móvel Provider1 e Provider2 e seus aplicativos de banda larga móvel correspondentes estiverem instalados, o aplicativo Provider1 não poderá usar nenhuma ID de conta de rede Provider2 e vice-versa. A função que retorna todas as IDs da conta de rede retornará apenas as IDs das contas de rede do MNO cujo aplicativo está chamando a função. Uma tentativa de usar uma ID de conta de rede que pertença a um MNO diferente resultará em um erro de "acesso negado".

Nota Aplicativos que não são aplicativos UWP (por exemplo, serviços Win32 ou aplicativos de área de trabalho) têm acesso a todas as contas de rede, independentemente do provedor de serviços de rede.

Visão geral da API winRT de banda larga móvel