Metode IMbnPinEvents::OnDisableComplete (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 penonaktifan PIN telah selesai.

Sintaks

HRESULT OnDisableComplete(
  [in] IMbnPin      *pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

Parameter

[in] pin

Antarmuka IMbnPin yang ditipe 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 Broadband Seluler untuk mengidentifikasi permintaan penonaktifan 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 GetPinStatedari IMbnPinManager untuk menemukan jenis PIN yang diharapkan.
E_MBN_SIM_NOT_INSERTED
 Tidak ada SIM di perangkat.
E_MBN_BAD_SIM
 Ada SIM buruk di perangkat.
E_MBN_FAILURE
 Ada upaya gagal untuk menggunakan PIN.

Mengembalikan nilai

Metode ini harus mengembalikan S_OK.

Keterangan

Metode OnDisableComplete dipanggil oleh layanan Mobile Broadband untuk melaporkan status penyelesaian operasi penonaktifan PIN yang diinisialisasi oleh panggilan ke metode NonaktifkanIMbnPin.

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 maka 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.

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