IMbnConnection::Metode connect (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.

Membuat koneksi data.

Sintaks

HRESULT Connect(
  [in]  MBN_CONNECTION_MODE connectionMode,
  [in]  LPCWSTR             strProfile,
  [out] ULONG               *requestID
);

Parameter

[in] connectionMode

Nilai MBN_CONNECTION_MODE yang menentukan mode koneksi.

[in] strProfile

Berisi penentu profil.

[out] requestID

Pointer ke ID permintaan unik yang dikembalikan oleh layanan Mobile Broadband untuk mengidentifikasi permintaan asinkron ini.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Layanan Broadband Seluler tidak berjalan pada sistem ini.
E_HANDLE	Antarmuka tidak valid. Kemungkinan besar perangkat Mobile Broadband telah dihapus dari sistem.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Antarmuka tidak valid. Kemungkinan besar perangkat Mobile Broadband telah dihapus dari sistem.
E_INVALIDARG	Nama profil yang tidak valid ditentukan atau argumen strProfile tidak sesuai dengan skema profil XML
E_MBN_MAX_ACTIVATED_CONTEXTS	Sudah ada konteks Mobile Broadband aktif. Beberapa konteks aktif tidak didukung.

Keterangan

Metode Sambungkan digunakan untuk mengaktifkan konteks koneksi untuk perangkat. Layanan Mobile Broadband saat ini mendukung paling banyak satu konteks aktif. Aktivasi konteks juga akan mengakibatkan koneksi L2 juga dibuat. Demikian pula, pennonaktifkan konteks akan mengakibatkan pemutusan koneksi data fisik ke jaringan seluler.

Jika perangkat tidak dalam status terpasang paket pada saat memanggil operasi ini, maka layanan Broadband Seluler akan secara implisit memasang paket perangkat sebelum mengeluarkan permintaan koneksi ke perangkat. Jika ada perubahan status layanan paket, aplikasi akan diberi tahu dengan panggilan ke metode OnPacketServiceStateChange dari antarmuka IMbnRegistrationEvents .

Jika connectionMode diatur ke MBN_CONNECTION_MODE_PROFILE, maka strProfile mewakili nama profil untuk perangkat. Jika diatur ke MBN_CONNECTION_MODE_TMP_PROFILE, maka strProfile mewakili representasi XML profil. Aplikasi panggilan dapat menggunakan IMbnConnectionProfileManager untuk mendapatkan daftar profil koneksi yang disimpan di perangkat.

Ini adalah operasi asinkron yang akan segera kembali. Jika metode ini berhasil dikembalikan, maka layanan Mobile Broadband akan memanggil metode OnConnectComplete dari IMbnConnectionEvents ketika operasi selesai.

Windows 8 dan versi Windows yang lebih baru: Aplikasi Windows Store dapat menggunakan Sambungkan hanya dengan MBN_CONNECTION_MODE_TMP_PROFILEconnectionMode dan parameter strProfile yang diatur ke representasi XML profil. Ini menyiratkan bahwa koneksi bersifat sementara dan tidak disimpan untuk digunakan di masa mendatang oleh sistem.

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

IMbnConnection

Bagikan melalui