Metode IMbnInterface::SetPreferredProviders (mbnapi.h)

Artikel
08/24/2023

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
S_OK	Metode berhasil diselesaikan.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Layanan Broadband Seluler tidak berjalan pada sistem ini.
E_HANDLE	Antarmuka tidak valid, kemungkinan besar karena perangkat Mobile Broadband telah dihapus dari sistem.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	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

IMbnInterface

Bagikan melalui