Metode IMbnInterface::GetReadyState (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 status siap.

Sintaks

HRESULT GetReadyState(
  [out, retval] MBN_READY_STATE *readyState
);

Parameter

[out, retval] readyState

Penunjuk ke struktur MBN_READY_STATE . Jika metode ini mengembalikan nilai apa pun selain S_OK, parameter ini adalah NULL.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan. readyState berisi nilai yang valid.
E_PENDING	Informasi tidak tersedia. Layanan Mobile Broadband saat ini sedang memeriksa status siap. Aplikasi panggilan bisa mendapatkan pemberitahuan ketika status siap tersedia dengan mendaftar untuk metode OnReadyStateChangedari IMbnInterfaceEvents.

Keterangan

Status siap menentukan apakah antarmuka berhasil diinisialisasi dan siap untuk melakukan operasi koneksi. Untuk perangkat berbasis SIM, perangkat siap ketika SIM telah berhasil diinisialisasi oleh perangkat. Perangkat dapat digunakan untuk koneksi hanya ketika status siap MBN_READY_STATE_INITIALIZED. Untuk informasi selengkapnya tentang status perangkat lain, lihat MBN_READY_STATE.

Status siap antarmuka dapat berubah sebagai akibat dari operasi pengguna. Misalnya, saat pengguna menyisipkan SIM ke perangkat, status siap berubah dari MBN_READY_STATE_SIM_NOT_INSERTED ke status siap lainnya. Status siap juga dapat berubah karena operasi lain yang dilakukan oleh aplikasi. Misalnya, ketika PIN telah dimasukkan, status siap dapat berubah dari MBN_READY_STATE_DEVICE_LOCKED ke status siap lainnya. Aplikasi dapat mendaftar untuk pemberitahuan peristiwa setiap kali ada perubahan dalam status siap antarmuka. Anggota OnReadyStateChange dari IMbnInterfaceEvents dipanggil untuk memberi tahu aplikasi tentang perubahan apa pun dalam status siap.

Subsistem SMS perangkat mungkin tidak siap saat melaporkan MBN_READY_STATE_INITIALIZED. Aplikasi panggilan harus menunggu panggilan ke anggota OnSmsConfigurationChange dari IMbnSmsEvents, yang menunjukkan bahwa subsistem SMS sudah siap.

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

IMbnInterface