ESim Класс

Определение

Пространство имен:

Windows.Networking.NetworkOperators

Класс, представляющий внедренную SIM-карту (eSIM или eUICC). ESIM хранит одно или несколько удостоверений (профилей eSIM), принадлежащих одному или нескольким операторам мобильной сети (MНКО). ESIM не является форм-фактором; это способ управления профилями SIM-карты.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

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

Наследование

Object Platform::Object IInspectable ESim

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Требования к Windows

Семейство устройств	Windows 10, version 1803 (появилось в 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v6.0)
Возможности приложения	Microsoft.eSIMManagement_8wekyb3d8bbwe

Комментарии

Традиционная SIM-карта хранит одно удостоверение, которое модем может использовать для регистрации в сети оператора мобильной сети (MNO) и предоставления услуг сотовой связи (карта обычно распространяется MNO). Но eSIM хранит одно или несколько удостоверений (профилей eSIM), принадлежащих одному или нескольким операторам мобильной связи. ESIM переключает удостоверения, включая и отключая профили eSIM, сохраненные на карта. После включения профиля eSIM появится eSIM и функционирует так, как если бы это была традиционная SIM-карта из MNO, распространяющего профиль. Таким образом, конечный пользователь может легко переключаться между MNOS, не изменяя физические карта.

Процесс установки профиля на eSIM выполняется в нескольких шагах. Конечный пользователь предоставляет код активации, который представляет собой строку, содержащую универсальное расположение ресурса (URL-адрес) сервера распространения профилей, а также некоторые идентифицирующие сведения. Затем устройство с поддержкой eSIM использует данные в коде активации для связи с сервером. Сервер возвращает метаданные для определенного профиля вместе с информацией, которая затем предоставляется пользователю, запрашивающего согласие на скачивание профиля. Получив согласие, устройство с поддержкой eSIM загружает профиль и отправляет двоичный blob-объект профиля в eSIM. Наконец, профиль готов к активации после успешной записи профиля в eSIM. LpaSvc — это служба для обработки всех запросов операций, связанных с eSIM. Для конечных пользователей в разделе Параметры есть страница Управление профилями eSIM, чтобы предоставить пользовательский интерфейс для управления eSIM.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1903	18362	Обнаружить
1903	18362	Discover(String;String)
1903	18362	DiscoverAsync
1903	18362	DiscoverAsync(String;String)

Свойства

AvailableMemoryInBytes	Возвращает доступную память на карта SIM-карты в целых байтах. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
Eid	Возвращает идентификатор eSIM (EID). Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
FirmwareVersion	Возвращает версию встроенного ПО eSIM. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
MobileBroadbandModemDeviceId	Возвращает идентификатор устройства или идентификатор DeviceInformation для сетевого устройства MobileBroadbandModem , которое содержит eSIM. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
Policy	Возвращает политику для eSIM, в отношении того, должен ли eSIM отображаться в локальном пользовательском интерфейсе (LUI) для управления eSIM. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
SlotIndex	Возвращает индекс слота на основе 0 (номер слота), которому соответствует eSim. ESim.SlotIndex соответствует свойству Index соответствующего объекта MobileBroadbandSlotInfo . Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
State	Возвращает состояние eSIM, указывающее наличие и рабочее состояние eSIM. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

Методы

DeleteProfileAsync(String)	Асинхронно удаляет указанный профиль eSIM. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
Discover()	Выполняет операцию обнаружения профиля eSIM, используя адрес SMDS по умолчанию. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
Discover(String, String)	Выполняет операцию обнаружения профиля eSIM для указанного адреса RSP-сервера и соответствующего идентификатора. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
DiscoverAsync()	Асинхронно выполняет операцию обнаружения профиля eSIM, используя адрес SMDS по умолчанию. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
DiscoverAsync(String, String)	Асинхронно выполняет операцию обнаружения профиля eSIM для указанного адреса RSP-сервера и соответствующего идентификатора. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
DownloadProfileMetadataAsync(String)	Асинхронно скачивает метаданные установки для профиля eSIM, соответствующего указанному коду активации. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
GetProfiles()	Возвращает набор профилей, хранящихся в eSIM. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.
ResetAsync()	Асинхронно сбрасывает eSIM. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

События

ProfileChanged

Происходит при изменении коллекции профилей eSIM или при изменении свойства одного из профилей в коллекции. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.