Compartir a través de


ESim Clase

Definición

Clase que representa un SIM incrustado (eSIM o eUICC). Un eSIM almacena una o varias identidades (perfiles de eSIM) que pertenecen a uno o varios operadores de red móvil (MNO). Un eSIM no es un factor de forma; es una manera de administrar perfiles sim.

Nota:

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

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
Herencia
Object Platform::Object IInspectable ESim
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10, version 1803 (se introdujo en la versión 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v6.0)
Características de aplicaciones
Microsoft.eSIMManagement_8wekyb3d8bbwe

Comentarios

Una tarjeta SIM tradicional almacena una única identidad que el módem puede usar para registrarse en la red de un operador de red móvil (MNO) y proporcionar servicio de telefonía móvil (la tarjeta normalmente se distribuye por el MNO). Pero un eSIM almacena una o varias identidades (perfiles de eSIM) que pertenecen a uno o varios operadores móviles. Un eSIM cambia las identidades habilitando y deshabilitando los perfiles de eSIM guardados en la tarjeta. Una vez habilitado un perfil de eSIM, el eSIM aparece y funciona como si fuera una tarjeta SIM tradicional del MNO que distribuyó el perfil. De esta manera, el usuario final puede cambiar fácilmente entre MNOs sin cambiar la tarjeta física.

Hay varios pasos en el proceso de instalar un perfil en un eSIM. El usuario final proporciona un código de activación, que es una cadena que contiene la ubicación uniforme de recursos (URL) de un servidor de distribución de perfiles junto con cierta información de identificación. A continuación, el dispositivo compatible con eSIM usa los datos del código de activación para ponerse en contacto con el servidor. El servidor devuelve los metadatos de un perfil específico, junto con la información que luego se presenta al usuario solicitando consentimiento para descargar el perfil. Una vez recibido el consentimiento, el dispositivo compatible con eSIM descarga el perfil y envía el blob binario del perfil al eSIM. Por último, el perfil está listo para activarse cuando el perfil se escribe correctamente en el eSIM. LpaSvc es un servicio para controlar todas las solicitudes de operación relacionadas con eSIM. Para los usuarios finales, hay una página Administrar perfiles de eSIM en Configuración para proporcionar una interfaz de usuario para administrar el eSIM.

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1903 18362 Descubra
1903 18362 Discover(String,String)
1903 18362 DiscoverAsync
1903 18362 DiscoverAsync(String,String)

Propiedades

AvailableMemoryInBytes

Obtiene la memoria disponible en la tarjeta SIM en bytes enteros.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

Eid

Obtiene el id. de eSIM (EID).

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

FirmwareVersion

Obtiene la versión de firmware de eSIM.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

MobileBroadbandModemDeviceId

Obtiene el identificador de dispositivo, o id. deviceInformation, de la red MobileBroadbandModem dispositivo que lleva el eSIM.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

Policy

Obtiene la directiva para eSIM, con respecto a si el eSIM debe mostrarse en la interfaz de usuario local (LUI) para la administración de eSIM.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

SlotIndex

Obtiene el índice de ranura basado en 0 (número de ranura) al que corresponde eSim. ESim.SlotIndex coincide con la propiedad Index del objeto MobileBroadbandSlotInfo correspondiente.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

State

Obtiene el estado del eSIM, que indica la presencia y el estado de funcionamiento del eSIM.

Nota:

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

Métodos

DeleteProfileAsync(String)

Elimina de forma asincrónica el perfil de eSIM especificado.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

Discover()

Realiza una operación de detección de perfiles de eSIM mediante la dirección SMDS predeterminada.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

Discover(String, String)

Realiza una operación de detección de perfiles de eSIM para la dirección del servidor RSP proporcionada y el identificador coincidente.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

DiscoverAsync()

Realiza de forma asincrónica una operación de detección de perfiles de eSIM mediante la dirección SMDS predeterminada.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

DiscoverAsync(String, String)

Realiza de forma asincrónica una operación de detección de perfiles de eSIM para la dirección del servidor RSP proporcionada y el identificador coincidente.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

DownloadProfileMetadataAsync(String)

Descarga de forma asincrónica los metadatos de instalación para el perfil de eSIM que corresponde al código de activación especificado.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

GetProfiles()

Obtiene el conjunto de perfiles almacenados en eSIM.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

ResetAsync()

Restablece de forma asincrónica el eSIM.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

Eventos

ProfileChanged

Se produce cuando cambia la colección de perfiles de eSIM o cuando cambia una propiedad de uno de los perfiles de la colección.

Nota

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.eSIMManagement_8wekyb3d8bbwe. Para obtener más información, consulta Funcionalidades personalizadas.

Se aplica a