ESim Classe

Definizione

Spazio dei nomi:

Windows.Networking.NetworkOperators

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)]
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

Ereditarietà

Object Platform::Object IInspectable ESim

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

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.