ESim Kelas

Referensi

Definisi

Ruang nama:: Windows.Networking.NetworkOperators

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

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: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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