Metode IMbnPinManagerEvents::OnGetPinStateComplete (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 dipanggil oleh layanan Mobile Broadband untuk menunjukkan penyelesaian operasi asinkron yang dipicu oleh panggilan ke metode GetPinState IMbnPinManager.

Sintaks

HRESULT OnGetPinStateComplete(
  [in] IMbnPinManager *pinManager,
  [in] MBN_PIN_INFO   pinInfo,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Parameter

[in] pinManager

Penunjuk ke antarmuka IMbnPinManager yang mewakili perangkat Mobile Broadband tempat operasi dilakukan.

[in] pinInfo

Struktur MBN_PIN_INFO yang berisi informasi PIN perangkat.

Jika pinInfo.pinState diatur ke MBN_PIN_STATE_NONE maka tidak ada PIN yang diharapkan dimasukkan oleh perangkat.

Jika pinInfo.pinState diatur ke MBN_PIN_STATE_ENTER maka perangkat mengharapkan PIN dimasukkan dan pinInfo.pinType mewakili jenis PIN yang diharapkan oleh perangkat.

Jika pinInfo.pinState diatur ke MBN_PIN_STATE_UNBLOCK maka perangkat diblokir PIN dan operasi pemblokiran PIN harus dicoba untuk membuka blokir perangkat. Dalam hal ini, pinInfo.pinType mewakili jenis PIN tempat operasi buka blokir harus dilakukan.

Jika pinInfo.pinState diatur ke MBN_PIN_STATE_ENTER atau MBN_PIN_STATE_UNBLOCK, pinInfo.attemptsRemaining berisi jumlah upaya yang tersisa untuk memasukkan KUNCI buka blokir PIN (PUK) yang valid. Jika jumlah upaya yang tersisa tidak diketahui, maka pinInfo.attemptsRemaining diatur ke MBN_ATTEMPTS_REMAINING_UNKNOWN.

[in] requestID

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

[in] status

Status penyelesaian 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 PIN.
E_MBN_SIM_NOT_INSERTED	Operasi tidak dapat diselesaikan karena SIM tidak ada di perangkat.
E_MBN_BAD_SIM	Operasi tidak dapat diselesaikan karena SIM buruk terdeteksi di perangkat.

Menampilkan nilai

Metode ini harus mengembalikan S_OK.

Keterangan

Metode ini dipanggil oleh layanan Mobile Broadband untuk memberi tahu aplikasi tentang penyelesaian operasi asinkron yang dipicu oleh panggilan ke metode GetPinState IMbnPinManager.
Setelah berhasil diselesaikan, pinInfo berisi informasi tentang PIN berikutnya yang diharapkan oleh perangkat.

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

IMbnPinManagerEvents

Bagikan melalui