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 是否應該顯示在 eSIM 管理的本機使用者介面 (LUI) 。 注意 這項功能僅適用于行動電信業者提供特殊許可權存取權的電信業者應用程式和 UWP 應用程式。 如果您想要使用此 API 並將您的應用程式發佈至 Microsoft Store，則必須要求特殊核准，才能使用自訂功能 Microsoft.eSIMManagement_8wekyb3d8bbwe。 如需詳細資訊，請參閱 自訂功能。
SlotIndex	取得 eSim 對應) 以 0 為基礎的位置索引 (位置編號。 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 伺服器位址和相符識別碼執行 eSIM 設定檔探索作業。 注意 這項功能僅適用于行動電信業者提供特殊許可權存取權的電信業者應用程式和 UWP 應用程式。 如果您想要使用此 API 並將您的應用程式發佈至 Microsoft Store，則必須要求特殊核准，才能使用自訂功能 Microsoft.eSIMManagement_8wekyb3d8bbwe。 如需詳細資訊，請參閱 自訂功能。
DiscoverAsync()	使用預設 SMDS 位址，以非同步方式執行 eSIM 設定檔探索作業。 注意 這項功能僅適用于行動電信業者提供特殊許可權存取權的電信業者應用程式和 UWP 應用程式。 如果您想要使用此 API 並將您的應用程式發佈至 Microsoft Store，則必須要求特殊核准，才能使用自訂功能 Microsoft.eSIMManagement_8wekyb3d8bbwe。 如需詳細資訊，請參閱 自訂功能。
DiscoverAsync(String, String)	針對提供的 RSP 伺服器位址和相符識別碼，以非同步方式執行 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。 如需詳細資訊，請參閱 自訂功能。