Bagikan melalui


ESim Kelas

Definisi

Kelas yang mewakili SIM tertanam (eSIM, atau eUICC). eSIM menyimpan satu atau beberapa identitas (profil eSIM) milik satu atau beberapa operator jaringan seluler (MNO). eSIM bukan faktor bentuk; ini adalah cara untuk mengelola profil SIM.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberikan akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan menerbitkan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

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
Warisan
Object Platform::Object IInspectable ESim
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10, version 1803 (diperkenalkan dalam 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v6.0)
Kemampuan aplikasi
Microsoft.eSIMManagement_8wekyb3d8bbwe

Keterangan

Kartu SIM tradisional menyimpan satu identitas yang dapat digunakan modem untuk mendaftar ke jaringan operator jaringan seluler (MNO), dan menyediakan layanan seluler (kartu biasanya didistribusikan oleh MNO). Tetapi eSIM menyimpan satu atau beberapa identitas (profil eSIM) milik satu atau beberapa operator seluler. eSIM mengalihkan identitas dengan mengaktifkan dan menonaktifkan profil eSIM yang disimpan di kartu. Setelah profil eSIM diaktifkan, eSIM muncul dan berfungsi seolah-olah itu adalah kartu SIM tradisional dari MNO yang mendistribusikan profil. Dengan cara ini, pengguna akhir dapat dengan mudah beralih antara MNO tanpa mengubah kartu fisik.

Ada beberapa langkah dalam proses menginstal profil ke eSIM. Pengguna akhir menyediakan kode aktivasi, yang merupakan string yang berisi lokasi sumber daya seragam (URL) server yang didistribusikan profil bersama dengan beberapa informasi identifikasi. Selanjutnya, perangkat berkemampuan eSIM menggunakan data dalam kode aktivasi untuk menghubungi server. Server mengembalikan metadata untuk profil tertentu, bersama dengan informasi yang kemudian disajikan kepada pengguna yang meminta persetujuan untuk mengunduh profil. Setelah menerima persetujuan, perangkat berkemampuan eSIM mengunduh profil dan mengirim blob biner profil ke eSIM. Terakhir, profil siap diaktifkan ketika profil berhasil ditulis ke eSIM. LpaSvc adalah layanan untuk menangani semua permintaan operasi terkait eSIM. Untuk pengguna akhir, ada halaman Mengelola profil eSIM di Pengaturan untuk menyediakan UI untuk mengelola eSIM.

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1903 18362 Temukan
1903 18362 Discover(String,String)
1903 18362 DiscoverAsync
1903 18362 DiscoverAsync(String,String)

Properti

AvailableMemoryInBytes

Mendapatkan memori yang tersedia pada kartu SIM dalam byte utuh.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

Eid

Mendapatkan ID eSIM (ID).

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

FirmwareVersion

Mendapatkan versi firmware eSIM.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

MobileBroadbandModemDeviceId

Mendapatkan pengidentifikasi perangkat, atau Id DeviceInformation, dari perangkat MobileBroadbandModem jaringan yang membawa eSIM.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

Policy

Mendapatkan kebijakan untuk eSIM, mengenai apakah eSIM harus ditampilkan pada Antarmuka Pengguna Lokal (LUI) untuk manajemen eSIM.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

SlotIndex

Mendapatkan indeks slot berbasis 0 (nomor slot) yang sesuai dengan eSim. ESim.SlotIndex cocok dengan properti Indeks dari objek MobileBroadbandSlotInfo yang sesuai.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

State

Mendapatkan status eSIM, yang menunjukkan kehadiran dan status kerja eSIM.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberikan akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan menerbitkan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

Metode

DeleteProfileAsync(String)

Menghapus profil eSIM yang ditentukan secara asinkron.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

Discover()

Melakukan operasi penemuan profil eSIM menggunakan alamat SMDS default.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

Discover(String, String)

Melakukan operasi penemuan profil eSIM untuk alamat server RSP yang disediakan dan ID yang cocok.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

DiscoverAsync()

Secara asinkron melakukan operasi penemuan profil eSIM menggunakan alamat SMDS default.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

DiscoverAsync(String, String)

Secara asinkron melakukan operasi penemuan profil eSIM untuk alamat server RSP yang disediakan dan ID yang cocok.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

DownloadProfileMetadataAsync(String)

Secara asinkron mengunduh metadata penginstalan untuk profil eSIM yang sesuai dengan kode aktivasi yang ditentukan.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

GetProfiles()

Mendapatkan kumpulan profil yang disimpan di eSIM.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

ResetAsync()

Secara asinkron mengatur ulang eSIM.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

Acara

ProfileChanged

Terjadi ketika kumpulan profil eSIM berubah, atau saat properti salah satu profil dalam koleksi berubah.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.eSIMManagement_8wekyb3d8bbwe. Untuk informasi selengkapnya, lihat Kemampuan kustom.

Berlaku untuk