Metode IMbnPinEvents::OnChangeComplete (mbnapi.h)

  • Artikel
  • 2 menit untuk membaca

Penting

Mulai dari Windows 10, versi 1803, API Win32 yang dijelaskan di bagian ini digantikan oleh API Windows Runtime di namespace Layanan Windows.Networking.Connectivity.

Metode pemberitahuan yang dipanggil oleh layanan Mobile Broadband untuk menunjukkan bahwa operasi perubahan PIN telah selesai.

Sintaks

HRESULT OnChangeComplete(
  [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 Broadband Seluler untuk mengidentifikasi permintaan perubahan PIN.

[in] status

Kode status yang menunjukkan hasil operasi perubahan PIN.

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_PIN_DISABLED
 Operasi perubahan PIN tidak didukung untuk PIN yang dinonaktifkan.

Mengembalikan nilai

Metode ini harus mengembalikan S_OK.

Keterangan

Metode OnChangeComplete dipanggil oleh layanan Mobile Broadband untuk melaporkan status penyelesaian operasi perubahan PIN yang diinisialisasi oleh panggilan ke metode PerubahanIMbnPin.

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