ESim クラス

リファレンス

定義

名前空間:: Windows.Networking.NetworkOperators

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

埋め込み 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)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ESim final

/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ESim

[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 ThreadingAttribute

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を使用するために特別な承認を要求する必要があります。詳細については、「カスタム機能」を参照してください。

適用対象