Metode IMbnInterface::SetPreferredProviders (mbnapi.h)
Penting
Mulai dari Windows 10, versi 1803, API Win32 yang dijelaskan di bagian ini digantikan oleh WINDOWS Runtime API di namespace Windows.Networking.Connectivity.
Updates daftar penyedia pilihan untuk perangkat.
Sintaks
HRESULT SetPreferredProviders(
[in] SAFEARRAY *preferredProviders,
[out] ULONG *requestID
);
Parameter
[in] preferredProviders
Array struktur MBN_PROVIDER yang berisi daftar penyedia pilihan.
[out] requestID
Arahkan ke ID permintaan yang ditetapkan oleh sistem operasi untuk permintaan ini. Respons asinkron akan berisi requestID yang sama ini.
Menampilkan nilai
Metode ini dapat mengembalikan salah satu nilai ini.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil diselesaikan. |
|
Layanan Broadband Seluler tidak berjalan pada sistem ini. |
|
Antarmuka tidak valid, kemungkinan besar karena perangkat Mobile Broadband telah dihapus dari sistem. |
|
Antarmuka tidak valid. Kemungkinan besar karena perangkat Mobile Broadband telah dihapus dari sistem. |
Keterangan
Metode SetPreferredProviders memulai pembaruan daftar penyedia pilihan untuk antarmuka. Ini adalah operasi asinkron, dan panggilan metode segera kembali. Jika metode ini berhasil dikembalikan (dengan S_OK), maka sistem operasi akan memberi tahu aplikasi panggilan tentang status penyelesaian operasi ini dengan memanggil metode OnSetPreferredProvidersComplete dari IMbnInterfaceEvents.
Jika perangkat dihapus dari sistem sebelum operasi ini selesai, maka tidak ada jaminan bahwa pemberitahuan penyelesaian akan diterima oleh aplikasi panggilan.
Persyaratan
Klien minimum yang didukung | Windows 7 [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Tidak ada yang didukung |
Target Platform | Windows |
Header | mbnapi.h |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk