IMbnPinManager::Metode GetPinList (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.

Mendapatkan daftar jenis PIN berbeda yang didukung oleh perangkat.

Sintaks

HRESULT GetPinList(
  [out, retval] SAFEARRAY **pinList
);

Parameter

[out, retval] pinList

Penunjuk ke daftar nilai MBN_PIN_TYPE yang mewakili jenis PIN yang didukung oleh perangkat. Ketika GetPinList mengembalikan apa pun selain S_OK, pinList adalah NULL, jika tidak, aplikasi panggilan harus membebaskan memori yang dialokasikan dengan memanggil SafeArrayDestroy.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.
E_PENDING
 Jenis PIN tidak tersedia. Layanan Mobile Broadband saat ini sedang memeriksa perangkat untuk mendapatkan informasi. Ketika jenis PIN tersedia, layanan Mobile Broadband akan memanggil metode OnPinListAvailabledari IMbnPinManagerEvents.
E_MBN_PIN_REQUIRED
 Perangkat mengharuskan PIN harus dimasukkan untuk operasi ini.
E_MBN_SIM_NOT_INSERTED
 SIM tidak disisipkan.
E_MBN_BAD_SIM
 SIM buruk dimasukkan ke dalam perangkat.

Keterangan

Pada kesalahan yang dapat dipulihkan E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED, dan E_MBN_BAD_SIM, layanan Mobile Broadband akan mencoba mengambil informasi ini dari perangkat ketika kondisi kesalahan berakhir. Saat mengambil informasi ini, panggilan GetPinList akan mengembalikan E_PENDING. Setelah operasi pengambilan selesai, layanan Mobile Broadband akan memanggil metode OnPinListAvailableIMbnPinManagerEvents.

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

IMbnPinManager