Metode IMbnInterface::GetVisibleProviders (mbnapi.h)

Artikel
03/09/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.

Mendapatkan daftar penyedia yang terlihat.

Sintaks

HRESULT GetVisibleProviders(
  [out, retval] ULONG     *age,
  [out, retval] SAFEARRAY **visibleProviders
);

Parameter

[out, retval] age

Penunjuk ke waktu dalam hitungan detik sejak refresh terakhir daftar penyedia yang terlihat dari perangkat.

[out, retval] visibleProviders

Penunjuk ke array struktur MBN_PROVIDER yang berisi daftar penyedia untuk antarmuka. Jika metode ini mengembalikan nilai apa pun selain S_OK, parameter ini adalah NULL. Jika tidak, setelah selesai, program panggilan harus membebaskan memori yang dialokasikan dengan memanggil SafeArrayDestroy.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan. visibleProviders berisi nilai yang valid. Berdasarkan usia informasi, aplikasi panggilan dapat memutuskan untuk mengeluarkan panggilan baru ke ScanNetwork.
E_PENDING	Informasi tidak tersedia. Pemindaian jaringan aktif sedang berlangsung. Aplikasi panggilan dapat mendapatkan pemberitahuan ketika kemampuan perangkat tersedia dengan mendaftar untuk metode OnScanNetworkComplete dari IMbnInterfaceEvents.
E_MBN_INVALID_CACHE	Cache Mobile Broadband dari daftar jaringan yang terlihat tidak valid. Aplikasi panggilan harus memanggil ScanNetwork untuk mengisi cache.

Keterangan

Metode ini mengembalikan daftar penyedia yang saat ini terlihat. Perangkat CDMA hanya akan melaporkan penyedia rumah mereka jika ada jaringan dalam daftar roaming (PRL) pilihan mereka yang tersedia.

Untuk menghindari operasi pemindaian jaringan yang sering, sistem operasi mempertahankan daftar operasi pemindaian terbaru dan daftar penyedia dikembalikan dari daftar yang di-cache.

Aplikasi dapat memanggil metode ini untuk mendapatkan daftar penyedia yang terlihat setelah penyelesaian ScanNetwork.

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

IMbnInterface

Bagikan melalui