Metode IMbnPinEvents::OnChangeComplete (mbnapi.h)

Artikel
08/24/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 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 Mobile Broadband 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 GetPinState IMbnPinManager 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.
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 Perubahan IMbnPin.

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 GetPinState IMbnPinManager 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