Metode IMbnConnectionEvents::OnConnectComplete (mbnapi.h)

Artikel
03/09/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.

Metode pemberitahuan yang menandakan penyelesaian operasi koneksi.

Sintaks

HRESULT OnConnectComplete(
  [in] IMbnConnection *newConnection,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Parameter

[in] newConnection

Antarmuka IMbnConnection yang mewakili perangkat tempat operasi koneksi selesai.

[in] requestID

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

[in] status

Status penyelesaian.

Aplikasi panggilan dapat mengharapkan salah satu nilai berikut.

Nilai	Makna
S_OK	Operasi berhasil.
E_MBN_SIM_NOT_INSERTED	Tidak ada SIM di perangkat.
E_MBN_PIN_REQUIRED	PIN diperlukan agar operasi selesai.
E_MBN_SERVICE_NOT_ACTIVATED	Langganan layanan jaringan telah kedaluwarsa.
E_MBN_PROVIDER_NOT_VISIBLE	Penyedia tidak terlihat. Ini hanya berlaku untuk mode pendaftaran manual.
E_MBN_INVALID_ACCESS_STRING	String akses koneksi tidak benar.
HRESULT_FROM_WIN32(ERROR_INVALID_PASSWORD)	Nama atau kata sandi yang digunakan di profil koneksi tidak benar.
E_MBN_VOICE_CALL_IN_PROGRESS	Panggilan suara aktif sedang berlangsung.
E_MBN_MAX_ACTIVATED_CONTEXTS	Sudah ada konteks Mobile Broadband yang aktif. Layanan Broadband Seluler saat ini tidak mendukung beberapa konteks aktif.
E_MBN_RADIO_POWER_OFF	Radio perangkat mati.
E_MBN_PACKET_SVC_DETACHED	Tidak tersedia layanan paket terlampir aktif.
E_MBN_ACTIVE_CONNECTION	Perangkat sudah tersambung ke jaringan.

Menampilkan nilai

Metode ini harus mengembalikan S_OK.

Keterangan

Setelah konteks aktivasi ditetapkan, aplikasi dapat menggunakan IMbnConnection untuk mendapatkan status koneksi saat ini.

Ketika operasi koneksi menghasilkan kesalahan, aplikasi dapat memanggil metode GetActivationNetworkError dari antarmuka IMbnConnection untuk mendapatkan informasi kesalahan jaringan.

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

IMbnConnectionEvents

Bagikan melalui