ESim 类

定义

命名空间:

Windows.Networking.NetworkOperators

表示嵌入式 SIM (eSIM 或 eUICC) 的类。 eSIM 存储一个或多个标识 (eSIM 配置文件) 属于一个或多个移动网络运营商 (MNO) 。 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 会显示并运行，就像它是分发配置文件的 MNO 中的传统 SIM 卡一样。 这样，最终用户可以轻松地在 MNO 之间切换，而无需更改物理卡。

将配置文件安装到 eSIM 的过程中，有几个步骤。 最终用户提供激活代码，该字符串包含配置文件分发服务器的统一资源位置 (URL) 以及一些标识信息。 接下来，支持 eSIM 的设备使用激活代码中的数据来联系服务器。 服务器返回特定配置文件的元数据，以及随后提供给请求同意下载配置文件的用户的信息。 获得同意后，支持 eSIM 的设备将下载配置文件并将配置文件二进制 Blob 发送到 eSIM。 最后，配置文件已准备好在成功写入 eSIM 后激活。 LpaSvc 是一项服务，用于处理所有与 eSIM 相关的操作请求。 对于最终用户，“设置”中有一个“管理 eSIM 配置文件”页，用于提供用于管理 eSIM 的 UI。

版本历史记录

Windows 版本	SDK 版本	增值
1903	18362	发现
1903	18362	发现 (字符串，字符串)
1903	18362	DiscoverAsync
1903	18362	DiscoverAsync (String，String)

属性

AvailableMemoryInBytes	获取 SIM 卡上的可用内存卡（以整字节为单位）。 注意 此功能仅适用于移动运营商应用和由移动网络运营商授予特权访问权限的 UWP 应用。 如果要使用此 API 并将应用发布到 Microsoft Store，则需要请求特殊批准才能 Microsoft.eSIMManagement_8wekyb3d8bbwe使用自定义功能。 有关详细信息，请参阅 自定义功能。
Eid	获取 eSIM ID (EID) 。 注意 此功能仅适用于移动运营商应用和由移动网络运营商授予特权访问权限的 UWP 应用。 如果要使用此 API 并将应用发布到 Microsoft Store，则需要请求特殊批准才能 Microsoft.eSIMManagement_8wekyb3d8bbwe使用自定义功能。 有关详细信息，请参阅 自定义功能。
FirmwareVersion	获取 eSIM 固件版本。 注意 此功能仅适用于移动运营商应用和由移动网络运营商授予特权访问权限的 UWP 应用。 如果要使用此 API 并将应用发布到 Microsoft Store，则需要请求特殊批准才能 Microsoft.eSIMManagement_8wekyb3d8bbwe使用自定义功能。 有关详细信息，请参阅 自定义功能。
MobileBroadbandModemDeviceId	获取承载 eSIM 的网络 MobileBroadbandModem 设备的设备标识符或 DeviceInformation ID。 注意 此功能仅适用于移动运营商应用和由移动网络运营商授予特权访问权限的 UWP 应用。 如果要使用此 API 并将应用发布到 Microsoft Store，则需要请求特殊批准才能 Microsoft.eSIMManagement_8wekyb3d8bbwe使用自定义功能。 有关详细信息，请参阅 自定义功能。
Policy	获取 eSIM 的策略，该策略涉及是否应在本地用户界面上显示 eSIM， (LUI) 进行 eSIM 管理。 注意 此功能仅适用于移动运营商应用和由移动网络运营商授予特权访问权限的 UWP 应用。 如果要使用此 API 并将应用发布到 Microsoft Store，则需要请求特殊批准才能 Microsoft.eSIMManagement_8wekyb3d8bbwe使用自定义功能。 有关详细信息，请参阅 自定义功能。
SlotIndex	获取从 0 开始的槽索引 (eSim 所对应的槽号) 。 ESim.SlotIndex 与相应 MobileBroadbandSlotInfo 对象的 Index 属性匹配。 注意 此功能仅适用于移动运营商应用和由移动网络运营商授予特权访问权限的 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()	使用默认 SMDS 地址执行 eSIM 配置文件发现操作。 注意 此功能仅适用于移动运营商应用和由移动网络运营商授予特权访问权限的 UWP 应用。 如果要使用此 API 并将应用发布到 Microsoft Store，则需要请求特殊批准才能 Microsoft.eSIMManagement_8wekyb3d8bbwe使用自定义功能。 有关详细信息，请参阅 自定义功能。
Discover(String, String)	对提供的 RSP 服务器地址和匹配的 ID 执行 eSIM 配置文件发现操作。 注意 此功能仅适用于移动运营商应用和由移动网络运营商授予特权访问权限的 UWP 应用。 如果要使用此 API 并将应用发布到 Microsoft Store，则需要请求特殊批准才能 Microsoft.eSIMManagement_8wekyb3d8bbwe使用自定义功能。 有关详细信息，请参阅 自定义功能。
DiscoverAsync()	使用默认 SMDS 地址异步执行 eSIM 配置文件发现操作。 注意 此功能仅适用于移动运营商应用和由移动网络运营商授予特权访问权限的 UWP 应用。 如果要使用此 API 并将应用发布到 Microsoft Store，则需要请求特殊批准才能 Microsoft.eSIMManagement_8wekyb3d8bbwe使用自定义功能。 有关详细信息，请参阅 自定义功能。
DiscoverAsync(String, String)	为提供的 RSP 服务器地址和匹配 ID 异步执行 eSIM 配置文件发现操作。 注意 此功能仅适用于移动运营商应用和由移动网络运营商授予特权访问权限的 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使用自定义功能。 有关详细信息，请参阅 自定义功能。