Metode IMbnPinEvents::OnUnblockComplete (mbnapi.h)

  • Artikel

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 bahwa operasi pemblokiran PIN telah selesai

Sintaks

HRESULT OnUnblockComplete(
  [in] IMbnPin      *Pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

Parameter

[in] Pin

Antarmuka IMbnPin yang mewakili jenis PIN.

[in] pinInfo

Penunjuk ke struktur MBN_PIN_INFO yang berisi informasi tentang upaya yang tersisa, jika terjadi operasi kegagalan. Isi pinInfo hanya bermakna ketika statusE_MBN_FAILURE.

[in] requestID

ID permintaan yang ditetapkan oleh layanan Mobile Broadband untuk mengidentifikasi permintaan pemblokiran PIN.

[in] status

Kode status yang menunjukkan hasil 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 ini.
E_FAIL
 Operasi tidak dapat diselesaikan.
E_MBN_PIN_REQUIRED
 PIN diperlukan agar operasi selesai. Aplikasi panggilan dapat memanggil metode GetPinStateIMbnPinManager untuk menemukan jenis PIN yang diharapkan.
E_MBN_SIM_NOT_INSERTED
 Tidak ada SIM di perangkat.
E_MBN_BAD_SIM
 Ada SIM yang buruk di perangkat.

Mengembalikan nilai

Metode ini harus mengembalikan S_OK.

Keterangan

Metode OnUnblockComplete dipanggil oleh layanan Mobile Broadband untuk melaporkan status penyelesaian operasi pemblokiran PIN yang diinisialisasi oleh panggilan ke metode Buka BlokirIMbnPin.

Isi pinInfo hanya bermakna ketika statusE_MBN_FAILURE. Anggota pinState harus diabaikan dan bidang pinType diatur ke jenis PIN antarmuka IMbnPin saat ini. Struktur ini berisi upaya yang tersisa untuk memasukkan PIN yang valid.

Misalnya, jika PIN yang diteruskan untuk mengubah jenis PIN salah, operasi akan gagal dengan kode status E_MBN_FAILURE. Dalam hal ini, pinInfo.attemptsRemaining menentukan jumlah upaya yang tersisa untuk mencoba kembali operasi ini. Jika upaya berulang dengan PIN yang salah menyebabkan upayaRemaining menjadi 0 maka aplikasi dapat memanggil metode GetPinStateIMbnPinManager untuk mendapatkan jenis PIN yang diperlukan.

Jika perangkat gagal membuka blokir, dan jika pemblokiran PUK memiliki pin MBN_PIN_TYPE_PIN1 , maka itu juga akan mengakibatkan status siap perangkat berubah menjadi MBN_READY_STATE_BAD_SIM. Aplikasi panggilan akan diberi tahu tentang perubahan ReadyState melalui anggota OnReadyStateChange dari IMbnInterfaceEvents.

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

IMbnPinEvents