Metode IMbnConnectionContextEvents::OnSetProvisionedContextComplete (mbnapi.h)

Artikel
03/04/2024

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 yang dipanggil oleh layanan Mobile Broadband untuk menunjukkan bahwa konteks yang disediakan dalam perangkat telah ditetapkan.

Sintaks

HRESULT OnSetProvisionedContextComplete(
  [in] IMbnConnectionContext *newInterface,
  [in] ULONG                 requestID,
  [in] HRESULT               status
);

Parameter

[in] newInterface

Antarmuka IMbnConnectionContext yang mewakili perangkat yang konteksnya telah ditetapkan.

[in] requestID

ID permintaan yang ditetapkan oleh layanan Mobile Broadband untuk mengidentifikasi operasi yang mengatur konteks.

[in] status

Kode status yang menunjukkan hasil operasi.

Aplikasi panggilan dapat mengharapkan salah satu nilai berikut.

Nilai	Makna
S_OK	Operasi berhasil.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Perangkat tidak mendukung operasi ini.
E_MBN_PIN_REQUIRED	PIN diperlukan agar operasi selesai.
E_INVALIDARG	ID konteks atau ID penyedia yang diberikan dalam permintaan tidak valid.
E_MBN_BAD_SIM	Ada SIM buruk di perangkat.
HRESULT_FROM_WIN32(ERROR_WRITE_FAULT)	Pembaruan di SIM atau memori perangkat gagal.

Mengembalikan nilai

Metode ini harus mengembalikan S_OK.

Keterangan

Aplikasi panggilan dapat meneruskan antarmuka IMbnConnectionContext ke newInterface untuk mendapatkan daftar terbaru konteks yang disediakan di perangkat. Namun, karena operasi ini asinkron, aplikasi harus menunggu pemberitahuan OnProvisionedContextListChange sebelum menggunakan antarmuka ini untuk mendapatkan konteks.

Jika ada beberapa aplikasi yang terdaftar untuk menerima pemberitahuan, maka semuanya akan menerima pemberitahuan ini meskipun hanya salah satu dari mereka yang dapat memulai operasi ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	mbnapi.h

Lihat juga

IMbnConnectionContextEvents

Bagikan melalui