Metode IMbnInterface::GetPreferredProviders (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.

Mendapatkan daftar penyedia pilihan.

Sintaks

HRESULT GetPreferredProviders(
  [out, retval] SAFEARRAY **preferredProviders
);

Parameter

[out, retval] preferredProviders

Penunjuk ke array struktur MBN_PROVIDER yang berisi daftar penyedia pilihan. Jika metode ini mengembalikan nilai apa pun selain S_OK, parameter ini adalah NULL. Ketika GetPreferredProviders mengembalikan S_OK, aplikasi panggilan harus membebaskan memori yang dialokasikan dengan memanggil SafeArrayDestroy.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan. preferredProviders berisi nilai yang valid.
E_PENDING	Informasi tidak tersedia. Layanan Mobile Broadband saat ini sedang memeriksa daftar penyedia pilihan. Aplikasi panggilan dapat mendapatkan pemberitahuan ketika data tersedia dengan mendaftar untuk metode OnPreferredProvidersChange dari IMbnInterfaceEvents.
E_MBN_PIN_REQUIRED	Perangkat mengharuskan PIN harus dimasukkan untuk operasi ini.
E_MBN_SIM_NOT_INSERTED	SIM tidak disisipkan.
E_MBN_BAD_SIM	SIM buruk dimasukkan ke dalam perangkat.
HRESULT_FROM_WIN32(ERROR_READ_FAULT)	Tidak dapat membaca dari SIM atau memori perangkat. Misalnya, SIM tidak memiliki informasi penyedia pilihan yang disediakan.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Perangkat tidak mendukung operasi ini. Perangkat CDMA akan selalu mengembalikan nilai ini.

Keterangan

GetPreferredProviders mengembalikan daftar penyedia yang disimpan dalam daftar penyedia pilihan antarmuka.

Untuk kesalahan yang dapat dipulihkan E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED, dan E_MBN_BAD_SIM, layanan Broadband Seluler akan meminta perangkat lagi untuk daftar penyedia ketika kondisi kesalahan berakhir. Misalnya, jika perangkat mengharuskan PIN dimasukkan untuk mendapatkan daftar penyedia, maka GetPreferredProviders akan mengembalikan E_MBN_PIN_REQUIRED. Ketika aplikasi memasukkan PIN untuk membuka kunci perangkat, maka layanan Mobile Broadband akan kembali mencoba mendapatkan informasi ini dari perangkat.

Ketika sistem operasi mengkueri perangkat untuk mendapatkan daftar penyedia setelah terjadi kesalahan yang dapat dipulihkan, GetPreferredProviders segera mengembalikan E_PENDING. Setelah kueri baru selesai, pemberitahuan dikirim ke aplikasi panggilan menggunakan metode panggilan balik yang sesuai. Misalnya, setelah operasi buka kunci PIN berhasil, metode OnEnterCompletedari IMbnPinEvents akan dipanggil. Setelah pulih dari kesalahan kartu SIM, metode OnReadyStateChangeIMbnInterfaceEvents akan dipanggil.

Layanan Mobile Broadband akan memperbarui aplikasi tentang status kueri baru apa pun dengan memanggil metode OnPreferredProvidersChange dari IMbnInterfaceEvents.

Dalam beberapa kasus, daftar penyedia pilihan perangkat dapat diperbarui melalui jaringan melalui SMS atau OTA (pembaruan over-the-air). Sistem operasi akan memberi tahu penerapan setiap perubahan dalam daftar penyedia pilihan dengan memanggil metode OnPreferredProvidersChange dari IMbnInterfaceEvents.

Persyaratan

Persyaratan	Nilai
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