IMbnInterface::Metode ScanNetwork (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.

Secara asinkron memindai jaringan untuk mendapatkan daftar penyedia yang terlihat.

Sintaks

HRESULT ScanNetwork(
  [out] ULONG *requestID
);

Parameter

[out] requestID

Arahkan ke ID permintaan yang ditetapkan oleh sistem operasi untuk permintaan ini. Respons asinkron akan berisi requestID yang sama 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. Kemungkinan besar karena perangkat Mobile Broadband telah dihapus dari sistem.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Antarmuka tidak valid. Kemungkinan besar karena perangkat Mobile Broadband telah dihapus dari sistem.

Keterangan

Metode ini memulai operasi pemindaian jaringan. Ketika berhasil diselesaikan, ini mengisi cache sistem operasi dari penyedia dan aplikasi yang terlihat dapat memanggil metode GetVisibleProvidersIMbnInterface untuk mendapatkan daftar jaringan yang terlihat.

Ini adalah operasi yang memakan waktu. Oleh karena itu, aplikasi harus terlebih dahulu memanggil GetVisibleProviders dan harus memanggil ScanNetwork hanya ketika informasi cache sudah lama.

Ini adalah operasi asinkron dan ScanNetwork akan segera kembali. Jika metode ini berhasil dikembalikan (dengan S_OK), maka setelah menyelesaikan operasi pemindaian, sistem operasi akan memanggil metode OnScanNetworkComplete dari IMbnInterfaceEvents untuk memberi tahu aplikasi penyelesaian operasi.

Jika perangkat dihapus dari sistem sebelum operasi ini selesai, tidak ada jaminan bahwa pemberitahuan penyelesaian akan diterima oleh aplikasi.

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

IMbnInterface