ESim Clase

Definición

Espacio de nombres:

Windows.Networking.NetworkOperators

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

Herencia

Object Platform::Object IInspectable ESim

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

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.