Partager via


ESim Classe

Définition

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)]
/// [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
Héritage
Object Platform::Object IInspectable ESim
Attributs

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.

S’applique à