ESim Classe

Définition

Espace de noms:

Windows.Networking.NetworkOperators

Classe qui représente une carte SIM incorporée (eSIM ou eUICC). Une eSIM stocke une ou plusieurs identités (profils eSIM) appartenant à un ou plusieurs opérateurs de réseau mobile (MMO). Une eSIM n’est pas un facteur de forme ; il s’agit d’un moyen de gérer les profils SIM.

Notes

Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile.

Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.

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

Héritage

Object Platform::Object IInspectable ESim

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1803 (introduit dans 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v6.0)
Fonctionnalités de l’application	Microsoft.eSIMManagement_8wekyb3d8bbwe

Remarques

Un carte SIM traditionnel stocke une identité unique que le modem peut utiliser pour s’inscrire sur le réseau d’un opérateur de réseau mobile (MNO) et fournir un service cellulaire (le carte est généralement distribué par le MNO). Mais une eSIM stocke une ou plusieurs identités (profils eSIM) appartenant à un ou plusieurs opérateurs mobiles. Une eSIM change d’identité en activant et en désactivant les profils eSIM enregistrés sur le carte. Une fois qu’un profil eSIM est activé, l’eSIM s’affiche et fonctionne comme s’il s’agissait d’un carte SIM traditionnel à partir de l’authentification multifacteur qui a distribué le profil. De cette façon, l’utilisateur final peut facilement basculer entre les MMO sans modifier les carte physiques.

Il existe plusieurs étapes dans le processus d’installation d’un profil sur une eSIM. L’utilisateur final fournit un code d’activation, qui est une chaîne qui contient l’emplacement de ressource uniforme (URL) d’un serveur de distribution de profils ainsi que des informations d’identification. Ensuite, l’appareil compatible eSIM utilise les données du code d’activation pour contacter le serveur. Le serveur retourne les métadonnées d’un profil spécifique, ainsi que les informations qui sont ensuite présentées à l’utilisateur qui demande son consentement pour télécharger le profil. Après avoir reçu le consentement, l’appareil compatible eSIM télécharge le profil et envoie l’objet blob binaire de profil à l’eSIM. Enfin, le profil est prêt à être activé lorsque le profil est correctement écrit dans l’eSIM. LpaSvc est un service permettant de gérer toutes les demandes d’opérations liées à eSIM. Pour les utilisateurs finaux, il existe une page Gestion des profils eSIM dans Paramètres pour fournir une interface utilisateur pour la gestion de l’eSIM.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1903	18362	Découvrez
1903	18362	Discover(String,String)
1903	18362	DiscoverAsync
1903	18362	DiscoverAsync(String,String)

Propriétés

AvailableMemoryInBytes	Obtient la mémoire disponible sur le carte SIM en octets entiers. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
Eid	Obtient l’ID eSIM (EID). Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
FirmwareVersion	Obtient la version du microprogramme eSIM. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
MobileBroadbandModemDeviceId	Obtient l’identificateur de l’appareil, ou Id DeviceInformation, de l’appareil MobileBroadbandModem réseau qui transporte l’eSIM. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
Policy	Obtient la stratégie de l’eSIM, indiquant si l’eSIM doit être affichée sur l’interface utilisateur locale (LUI) pour la gestion eSIM. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
SlotIndex	Obtient l’index d’emplacement de base 0 (numéro d’emplacement) auquel correspond l’eSim. ESim.SlotIndex correspond à la propriété Index de l’objet MobileBroadbandSlotInfo correspondant. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
State	Obtient l’état de l’eSIM, qui indique la présence et l’status de travail de l’eSIM. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.

Méthodes

DeleteProfileAsync(String)	Supprime de manière asynchrone le profil eSIM spécifié. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
Discover()	Effectue une opération de découverte de profil eSIM à l’aide de l’adresse SMDS par défaut. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
Discover(String, String)	Effectue une opération de découverte de profil eSIM pour l’adresse du serveur RSP et l’ID correspondant fourni. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
DiscoverAsync()	Effectue de manière asynchrone une opération de découverte de profil eSIM à l’aide de l’adresse SMDS par défaut. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
DiscoverAsync(String, String)	Effectue de manière asynchrone une opération de découverte de profil eSIM pour l’adresse du serveur RSP et l’ID correspondant. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
DownloadProfileMetadataAsync(String)	Télécharge de manière asynchrone les métadonnées d’installation pour le profil eSIM qui correspond au code d’activation spécifié. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
GetProfiles()	Obtient l’ensemble de profils stockés sur l’eSIM. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.
ResetAsync()	Réinitialise de manière asynchrone l’eSIM. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.

Événements

ProfileChanged

Se produit lorsque la collection de profils eSIM change ou lorsqu’une propriété de l’un des profils de la collection change. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.eSIMManagement_8wekyb3d8bbwe. Pour plus d’informations, consultez Fonctionnalités personnalisées.