Metode IMbnInterfaceEvents::OnSetPreferredProvidersComplete (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.

Metode pemberitahuan ini dipanggil oleh layanan Mobile Broadband untuk menunjukkan penyelesaian operasi SetPreferredProviders .

Sintaks

HRESULT OnSetPreferredProvidersComplete(
  [in] IMbnInterface *newInterface,
  [in] ULONG         requestID,
  [in] HRESULT       status
);

Parameter

[in] newInterface

IMbnInterface yang mewakili perangkat tempat operasi ini dilakukan.

[in] requestID

ID permintaan yang ditetapkan oleh layanan Mobile Broadband untuk operasi asinkron ini.

[in] status

Status penyelesaian operasi.

Tabel berikut ini mencantumkan nilai yang valid untuk status ini.

Nilai	Makna
S_OK	Operasi berhasil.
E_MBN_PIN_REQUIRED	Perangkat memerlukan PIN untuk dimasukkan agar operasi ini selesai.
E_MBN_SIM_NOT_INSERTED	SIM tidak disisipkan.
E_MBN_BAD_SIM	SIM buruk dimasukkan ke dalam perangkat.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Perangkat tidak mendukung operasi ini.

Menampilkan nilai

Metode ini harus mengembalikan S_OK.

Keterangan

Jika operasi berhasil diselesaikan, yaitu, ketika statusS_OK, maka aplikasi dapat memanggil metode GetPreferredProviders dari IMbnInterface yang diteruskan untuk mendapatkan daftar penyedia pilihan yang diperbarui.

Jika beberapa aplikasi terdaftar untuk pemberitahuan, maka metode ini akan dipanggil pada semua aplikasi terdaftar. Ini berarti bahwa aplikasi yang tidak memulai operasi pembaruan juga akan menerima pemberitahuan.

Jika panggilan ke metode SetPreferredProvidersIMbnInterface menghasilkan perubahan dalam daftar penyedia pilihan, maka metode OnPreferredProvidersChangeIMbnInterfaceEvents tidak akan dipanggil.

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

IMbnInterfaceEvents