IMbnPinManager::Metode GetPinState (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 PIN perangkat saat ini.

Sintaks

HRESULT GetPinState(
  [out] ULONG *requestID
);

Parameter

[out] requestID

Pointer ke ID permintaan yang ditetapkan oleh layanan Mobile Broadband untuk permintaan asinkron ini. Respons akan berisi ID permintaan yang sama.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Layanan Broadband Seluler tidak berjalan pada sistem ini.
E_HANDLE	Antarmuka tidak valid, kemungkinan besar karena 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.

Keterangan

Metode GetPinState memulai permintaan asinkron untuk status PIN perangkat. Status PIN menunjukkan apakah PIN perlu dimasukkan agar operasi yang diminta selesai. Ini juga berisi informasi tentang jenis PIN mana yang diharapkan oleh perangkat dan secara opsional menyediakan jumlah upaya yang tersisa untuk memasukkan PIN yang valid.

Metode ini selalu mengembalikan status PIN perangkat saat ini. Ini tidak menyimpan status PIN pada saat objek ini dibuat. Sebaliknya selalu menghubungi perangkat dan mengembalikan status PIN perangkat saat ini.

Karena ini adalah operasi asinkron, GetPinState akan segera kembali. Setelah menyelesaikan operasi, layanan Mobile Broadband akan memanggil metode OnGetPinStateComplete dari IMbnPinManagerEvents.

Setiap kali operasi kembali E_MBN_PIN_REQUIRED atau status siap yang dilaporkan oleh perangkat MBN_READY_STATE_DEVICE_LOCKED, aplikasi harus menggunakan metode ini untuk mengkueri jenis PIN yang diperlukan untuk membuka kunci perangkat atau SIM.

Saat operasi ini sedang berlangsung, jika perangkat Mobile Broadband dihapus dari sistem maka panggilan ke metode OnGetPinStateCompletedari IMbnPinManagerEvents tidak dijamin.

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

IMbnPinManager