ESim Classe

Definição

Namespace:

Windows.Networking.NetworkOperators

Uma classe que representa um SIM inserido (eSIM ou eUICC). Um eSIM armazena uma ou mais identidades (perfis eSIM) pertencentes a uma ou mais MNOs (operadoras de rede móvel). Um eSIM não é um fator forma; é uma maneira de gerenciar perfis SIM.

Observação

Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel.

Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.

public ref class ESim sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ESim final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ESim

Public NotInheritable Class ESim

Herança

Object Platform::Object IInspectable ESim

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 1803 (introduzida na 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v6.0)
Funcionalidades do aplicativo	Microsoft.eSIMManagement_8wekyb3d8bbwe

Comentários

Uma cartão SIM tradicional armazena uma única identidade que o modem pode usar para se registrar na rede de uma operadora de rede móvel (MNO) e fornecer serviço de celular (o cartão geralmente é distribuído pelo MNO). Mas um eSIM armazena uma ou mais identidades (perfis eSIM) pertencentes a uma ou mais operadoras móveis. Um eSIM alterna identidades habilitando e desabilitando os perfis do eSIM salvos no cartão. Depois que um perfil eSIM é habilitado, o eSIM aparece e funciona como se fosse uma cartão SIM tradicional do MNO que distribuiu o perfil. Dessa forma, o usuário final pode alternar facilmente entre MNOs sem alterar a cartão física.

Há várias etapas no processo de instalação de um perfil em um eSIM. O usuário final fornece um código de ativação, que é uma cadeia de caracteres que contém a URL (localização de recurso uniforme) de um servidor de distribuição de perfil junto com algumas informações de identificação. Em seguida, o dispositivo compatível com eSIM usa os dados no código de ativação para entrar em contato com o servidor. O servidor retorna os metadados de um perfil específico, juntamente com informações que são apresentadas ao usuário solicitando consentimento para baixar o perfil. Após receber consentimento, o dispositivo compatível com eSIM baixa o perfil e envia o blob binário de perfil para o eSIM. Por fim, o perfil está pronto para ser ativado quando o perfil é gravado com êxito no eSIM. O LpaSvc é um serviço para lidar com todas as solicitações de operação relacionadas ao eSIM. Para usuários finais, há uma página Gerenciando perfis eSIM em Configurações para fornecer uma interface do usuário para gerenciar o eSIM.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1903	18362	Descobrir
1903	18362	Discover(String,String)
1903	18362	DiscoverAsync
1903	18362	DiscoverAsync(String,String)

Propriedades

AvailableMemoryInBytes	Obtém a memória disponível no cartão SIM em bytes inteiros. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
Eid	Obtém a EID (ID do eSIM). Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
FirmwareVersion	Obtém a versão do firmware do eSIM. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
MobileBroadbandModemDeviceId	Obtém o identificador do dispositivo, ou ID deviceInformation, do dispositivo MobileBroadbandModem de rede que carrega o eSIM. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
Policy	Obtém a política para o eSIM, sobre se o eSIM deve ser mostrado na LUI (Interface do Usuário Local) para o gerenciamento do eSIM. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
SlotIndex	Obtém o índice de slot baseado em 0 (número do slot) ao qual o eSim corresponde. ESim.SlotIndex corresponde à propriedade Index do objeto MobileBroadbandSlotInfo correspondente. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
State	Obtém o estado do eSIM, que indica a presença e a status de trabalho do eSIM. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.

Métodos

DeleteProfileAsync(String)	Exclui de forma assíncrona o perfil eSIM especificado. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
Discover()	Executa uma operação de descoberta de perfil do eSIM usando o endereço SMDS padrão. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
Discover(String, String)	Executa uma operação de descoberta de perfil do eSIM para o endereço do servidor RSP fornecido e a ID correspondente. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
DiscoverAsync()	Executa de forma assíncrona uma operação de descoberta de perfil do eSIM usando o endereço SMDS padrão. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
DiscoverAsync(String, String)	Executa de forma assíncrona uma operação de descoberta de perfil do eSIM para o endereço do servidor RSP fornecido e a ID correspondente. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
DownloadProfileMetadataAsync(String)	Baixa de forma assíncrona os metadados de instalação para o perfil eSIM que corresponde ao código de ativação especificado. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
GetProfiles()	Obtém o conjunto de perfis armazenados no eSIM. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.
ResetAsync()	Redefine de forma assíncrona o eSIM. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.

Eventos

ProfileChanged

Ocorre quando a coleção de perfis eSIM é alterada ou quando uma propriedade de um dos perfis na coleção é alterada. Observação Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel. Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obter mais informações, consulte Recursos personalizados.