ESim クラス

定義

名前空間:

Windows.Networking.NetworkOperators

埋め込み SIM (eSIM、または eUICC) を表すクラス。 eSIM には、1 つ以上のモバイル ネットワーク オペレーター (MNO) に属する 1 つ以上の ID (eSIM プロファイル) が格納されます。 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) ネットワークに登録し、携帯電話サービスを提供するために使用できる 1 つの ID が格納されます (カードは通常、MNO によって配布されます)。 ただし、eSIM には、1 つ以上の携帯電話会社に属する 1 つ以上の ID (eSIM プロファイル) が格納されます。 eSIM は、カードに保存されている eSIM プロファイルを有効または無効にすることで ID を切り替えます。 eSIM プロファイルが有効になると、eSIM が表示され、プロファイルを配布した MNO の従来の SIM カードのように機能します。 このようにして、エンド ユーザーは物理カードを変更せずに MNO を簡単に切り替えることができます。

プロファイルを eSIM にインストールするプロセスには、いくつかの手順があります。 エンド ユーザーはアクティブ化コードを提供します。これは、プロファイル配布サーバーの一様なリソースの場所 (URL) と一部の識別情報を含む文字列です。 次に、eSIM 対応デバイスは、アクティブ化コードのデータを使用してサーバーに接続します。 サーバーは、特定のプロファイルのメタデータと、プロファイルのダウンロードに同意を求めるユーザーに提示される情報を返します。 同意を受け取った eSIM 対応デバイスは、プロファイルをダウンロードし、プロファイル バイナリ BLOB を eSIM に送信します。 最後に、プロファイルが eSIM に正常に書き込まれたら、プロファイルをアクティブ化する準備ができました。 LpaSvc は、すべての eSIM 関連の操作要求を処理するためのサービスです。 エンド ユーザーの場合は、[設定] の [eSIM プロファイルの管理] ページがあり、eSIM を管理するための UI を提供します。

バージョン履歴

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 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 管理用のローカル ユーザー インターフェイス (LUI) に eSIM を表示する必要があるかどうかに関する eSIM のポリシーを取得します。 注意 この機能は、モバイル ネットワーク オペレーターによる特権アクセス権を持つモバイル オペレーター アプリと 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 サーバー アドレスと一致する 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を使用するために特別な承認を要求する必要があります。 詳細については、「 カスタム機能」を参照してください。