WiFiOnDemandHotspotNetwork Kelas

Definisi

Catatan

Beberapa informasi berkaitan dengan produk yang telah dirilis sebelumnya, yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Penting

API ini akan dipengaruhi oleh perubahan perilaku sistem operasi yang akan datang, yang direncanakan pada musim gugur 2024. Untuk informasi selengkapnya, lihat Perubahan perilaku API untuk akses dan lokasi Wi-Fi.

Mewakili perangkat yang mendukung hotspot sesuai permintaan. Aplikasi ini mendaftarkan perangkat tersebut dengan sistem operasi (OS), di mana aplikasi dapat mengaktifkan hotspot seluler dari jarak jauh. Dengan memperbarui properti pada objek ini, aplikasi dapat memberi sinyal ke OS untuk memperbarui antarmuka pengguna (UI). Objek dikunci pada pengidentifikasi unik global (GUID) yang dipilih penelepon yang dimaksudkan untuk mengidentifikasi perangkat (properti Id ).

Catatan

Jika Anda ingin menggunakan API ini di aplikasi UWP, dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (kemampuan Jaringan Sesuai Permintaan). Untuk informasi selengkapnya, lihat Kemampuan kustom.

Kemampuan Jaringan Sesuai Permintaan hanya akan tersedia untuk pengembang aplikasi yang membangun skenario hotspot Wi-Fi end-to-end antara perangkat keras berkemampuan tethering dan PC Windows.

public ref class WiFiOnDemandHotspotNetwork sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 983040)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class WiFiOnDemandHotspotNetwork final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 983040)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class WiFiOnDemandHotspotNetwork
Public NotInheritable Class WiFiOnDemandHotspotNetwork
Warisan
Object Platform::Object IInspectable WiFiOnDemandHotspotNetwork
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 11 Insider Preview (diperkenalkan dalam 10.0.23504.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v15.0)
Kemampuan aplikasi
onDemandHotspotControl

Contoh

Sampel Hotspot Sesuai Permintaan

Keterangan

Hotspot sesuai permintaan adalah fitur di Windows yang memungkinkan perangkat klien Windows untuk melihat dan mengaktifkan titik akses hotspot seluler/berbagi internet dari jarak jauh pada perangkat Windows host (PC atau telepon), dan menyambungkannya. Hal ini memungkinkan perangkat klien untuk berbagi koneksi internet perangkat host. Fungsionalitas ini diekspos ke pengguna dengan menyuntikkan jaringan Wi-Fi ke dalam daftar jaringan klien saat pengguna membuka Wi-Fi Pengaturan Cepat atau Wi-Fi jaringan yang tersedia Pengaturan Sistem (Windows 11).

Aplikasi ini bertanggung jawab untuk menentukan cara berkomunikasi dengan hotspot untuk mendapatkan metadata, di luar API ini.

Properti

Id

Catatan

Beberapa informasi berkaitan dengan produk yang telah dirilis sebelumnya, yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Penting

API ini akan dipengaruhi oleh perubahan perilaku sistem operasi yang akan datang, yang direncanakan pada musim gugur 2024. Untuk informasi selengkapnya, lihat Perubahan perilaku API untuk akses dan lokasi Wi-Fi.

Pengidentifikasi unik global (GUID) yang dipilih penelepon yang dimaksudkan untuk mengidentifikasi hotspot.

Catatan

Jika Anda ingin menggunakan API ini di aplikasi UWP, dan menerbitkan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (kemampuan Jaringan Sesuai Permintaan). Untuk informasi selengkapnya, lihat Kemampuan kustom.

Kemampuan Jaringan Sesuai Permintaan hanya akan tersedia untuk pengembang aplikasi yang membangun skenario hotspot Wi-Fi end-to-end antara perangkat keras berkemampuan tethering dan PC Windows.

Metode

GetOrCreateById(Guid)

Catatan

Beberapa informasi berkaitan dengan produk yang telah dirilis sebelumnya, yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Penting

API ini akan dipengaruhi oleh perubahan perilaku sistem operasi yang akan datang, yang direncanakan pada musim gugur 2024. Untuk informasi selengkapnya, lihat Perubahan perilaku API untuk akses dan lokasi Wi-Fi.

Jika sistem operasi (OS) sudah dikonfigurasi dengan hotspot dari aplikasi panggilan, maka GetOrCreateById mengambil objek WiFiOnDemandHotspotNetwork yang sesuai dengan networkId yang diberikan. Jika tidak, metode membuat jaringan baru untuk id tersebut.

Catatan

Jika Anda ingin menggunakan API ini di aplikasi UWP, dan menerbitkan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (kemampuan Jaringan Sesuai Permintaan). Untuk informasi selengkapnya, lihat Kemampuan kustom.

Kemampuan Jaringan Sesuai Permintaan hanya akan tersedia untuk pengembang aplikasi yang membangun skenario hotspot Wi-Fi end-to-end antara perangkat keras berkemampuan tethering dan PC Windows.

GetProperties()

Catatan

Beberapa informasi berkaitan dengan produk yang telah dirilis sebelumnya, yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Penting

API ini akan dipengaruhi oleh perubahan perilaku sistem operasi yang akan datang, yang direncanakan pada musim gugur 2024. Untuk informasi selengkapnya, lihat Perubahan perilaku API untuk akses dan lokasi Wi-Fi.

Mengambil dari objek WiFiOnDemandHotspotNetwork berbagai properti jaringan hotspot, seperti persentase baterai, nama tampilan, ketersediaan, dan SSID/kata sandi.

Catatan

Jika Anda ingin menggunakan API ini di aplikasi UWP, dan menerbitkan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (kemampuan Jaringan Sesuai Permintaan). Untuk informasi selengkapnya, lihat Kemampuan kustom.

Kemampuan Jaringan Sesuai Permintaan hanya akan tersedia untuk pengembang aplikasi yang membangun skenario hotspot Wi-Fi end-to-end antara perangkat keras berkemampuan tethering dan PC Windows.

UpdateProperties(WiFiOnDemandHotspotNetworkProperties)

Catatan

Beberapa informasi berkaitan dengan produk yang telah dirilis sebelumnya, yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Penting

API ini akan dipengaruhi oleh perubahan perilaku sistem operasi yang akan datang, yang direncanakan pada musim gugur 2024. Untuk informasi selengkapnya, lihat Perubahan perilaku API untuk akses dan lokasi Wi-Fi.

Mengatur objek WiFiOnDemandHotspotNetwork berbagai properti jaringan hotspot, seperti persentase baterai, nama tampilan, ketersediaan, dan SSID/kata sandi. Jika ada properti yang tidak valid, UpdateProperties akan menampilkan pengecualian argumen yang tidak valid.

Catatan

Jika Anda ingin menggunakan API ini di aplikasi UWP, dan menerbitkan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (kemampuan Jaringan Sesuai Permintaan). Untuk informasi selengkapnya, lihat Kemampuan kustom.

Kemampuan Jaringan Sesuai Permintaan hanya akan tersedia untuk pengembang aplikasi yang membangun skenario hotspot Wi-Fi end-to-end antara perangkat keras berkemampuan tethering dan PC Windows.

Berlaku untuk

Lihat juga

  • <xref:%0a%0a-+%5bWiFiOnDemandHotspotUpdateMetadataTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotupdatemetadatatrigger)%0a-+%5bWiFiOnDemandHotspotConnectTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotconnecttrigger)>