Compartilhar via


ESim Classe

Definição

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)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ESim final
/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ESim
[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

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.

Aplica-se a