Condividi tramite


ESim Classe

Definizione

Classe che rappresenta una SIM incorporata (eSIM o eUICC). Un eSIM archivia una o più identità (profili eSIM) appartenenti a uno o più operatori di rete mobile (MNO). Un eSIM non è un fattore di forma; è un modo per gestire i profili SIM.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

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
Ereditarietà
Object Platform::Object IInspectable ESim
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v6.0)
Funzionalità dell'app
Microsoft.eSIMManagement_8wekyb3d8bbwe

Commenti

Una scheda SIM tradizionale archivia una singola identità che il modem può usare per registrarsi nella rete dell'operatore di rete mobile (MNO) e fornire il servizio cellulare (la scheda è in genere distribuita dal MNO). Ma un eSIM archivia una o più identità (profili eSIM) appartenenti a uno o più operatori di telefonia mobile. Un'eSIM cambia identità abilitando e disabilitando i profili eSIM salvati nella scheda. Dopo aver abilitato un profilo eSIM, l'eSIM viene visualizzato e funziona come se fosse una scheda SIM tradizionale dell'MNO che ha distribuito il profilo. In questo modo, l'utente finale può passare facilmente tra MNO senza modificare la scheda fisica.

Esistono diversi passaggi nel processo di installazione di un profilo in un'eSIM. L'utente finale fornisce un codice di attivazione, ovvero una stringa che contiene l'URL (Uniform Resource Location) di un server di distribuzione del profilo insieme ad alcune informazioni di identificazione. Successivamente, il dispositivo che supporta eSIM usa i dati nel codice di attivazione per contattare il server. Il server restituisce i metadati per un profilo specifico, insieme alle informazioni che vengono quindi presentate all'utente che richiede il consenso per scaricare il profilo. Dopo aver ricevuto il consenso, il dispositivo che supporta eSIM scarica il profilo e invia il BLOB binario del profilo all'eSIM. Infine, il profilo è pronto per essere attivato quando il profilo viene scritto correttamente nell'eSIM. LpaSvc è un servizio per la gestione di tutte le richieste di operazioni correlate a eSIM. Per gli utenti finali, è disponibile una pagina Gestione dei profili eSIM in Impostazioni per fornire un'interfaccia utente per la gestione dell'eSIM.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1903 18362 Rilevazione
1903 18362 Discover(String,String)
1903 18362 DiscoverAsync
1903 18362 DiscoverAsync(String,String)

Proprietà

AvailableMemoryInBytes

Ottiene la memoria disponibile nella scheda SIM in byte interi.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

Eid

Ottiene l'ID eSIM (EID).

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

FirmwareVersion

Ottiene la versione del firmware eSIM.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

MobileBroadbandModemDeviceId

Ottiene l'identificatore del dispositivo o l'ID DeviceInformation della rete MobileBroadbandModem che contiene l'eSIM.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

Policy

Ottiene i criteri per l'eSIM, per stabilire se l'eSIM deve essere visualizzato nell'interfaccia utente locale (LUI) per la gestione di eSIM.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

SlotIndex

Ottiene l'indice dello slot basato su 0 (numero di slot) a cui corrisponde l'eSim. ESim.SlotIndex corrisponde alla proprietà Index dell'oggetto MobileBroadbandSlotInfo corrispondente.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

State

Ottiene lo stato dell'eSIM, che indica la presenza e lo stato di lavoro dell'eSIM.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

Metodi

DeleteProfileAsync(String)

Elimina in modo asincrono il profilo eSIM specificato.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

Discover()

Esegue un'operazione di individuazione del profilo eSIM usando l'indirizzo SMDS predefinito.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

Discover(String, String)

Esegue un'operazione di individuazione del profilo eSIM per l'indirizzo del server RSP fornito e l'ID corrispondente.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

DiscoverAsync()

Esegue in modo asincrono un'operazione di individuazione del profilo eSIM usando l'indirizzo SMDS predefinito.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

DiscoverAsync(String, String)

Esegue in modo asincrono un'operazione di individuazione del profilo eSIM per l'indirizzo del server RSP fornito e l'ID corrispondente.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

DownloadProfileMetadataAsync(String)

Scarica in modo asincrono i metadati di installazione per il profilo eSIM che corrisponde al codice di attivazione specificato.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

GetProfiles()

Ottiene il set di profili archiviati nell'eSIM.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

ResetAsync()

Reimposta in modo asincrono l'eSIM.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

Eventi

ProfileChanged

Si verifica quando viene modificata la raccolta di profili eSIM o quando viene modificata una proprietà di uno dei profili nella raccolta.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP con accesso con privilegi da parte degli operatori di rete mobile.

Se vuoi usare questa API e pubblicare la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.eSIMManagement_8wekyb3d8bbwe. Per altre info, vedi Funzionalità personalizzate.

Si applica a