IMbnPin::Buka blokir metode (mbnapi.h)

Penting

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

Membuka blokir PIN yang diblokir.

Sintaks

HRESULT Unblock(
  [in]  LPCWSTR puk,
  [in]  LPCWSTR newPin,
  [out] ULONG   *requestID
);

Parameter

[in] puk

Nilai kunci buka blokir kata sandi (PUK) untuk jenis PIN ini.

[in] newPin

PIN baru yang akan diatur untuk jenis PIN ini.

[out] requestID

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

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Layanan Broadband Seluler tidak berjalan pada sistem ini.
E_HANDLE	Antarmuka tidak valid. Perangkat Mobile Broadband mungkin telah dihapus dari sistem.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Antarmuka tidak valid. Kemungkinan besar perangkat Mobile Broadband telah dihapus dari sistem.
E_ACCESSDENIED	Metode ini tidak diizinkan untuk memanggil hak istimewa proses.

Keterangan

Metode Buka Blokir membuka blokir PIN untuk jenis pin dengan memasukkan PUK dan mengatur PIN baru. Properti PinType dari IMbnPin ini mewakili jenis PIN yang sedang diubah.

Ini adalah operasi asinkron. Jika metode kembali dengan sukses, maka setelah menyelesaikan operasi, layanan Mobile Broadband akan memanggil metode OnUnblockComplete dari IMbnPinEvents.

Setiap kali metode GetPinState dari hasil IMbnPinManager dengan status PIN saat ini diatur ke MBN_PIN_STATE_UNBLOCK, maka aplikasi harus menggunakan Unblock pada jenis PIN yang dikembalikan dalam PinInfo.pinType yang diteruskan oleh metode OnGetPinStateComplete dari IMbnPinManagerEvents.

Memanggil metode ini memerlukan hak istimewa administrator.

Persyaratan

Persyaratan	Nilai
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

IMbnPin