Fungsi WlanHostedNetworkQueryStatus (wlanapi.h)

Artikel
03/13/2024

Fungsi WlanHostedNetworkQueryStatus meminta status Jaringan Yang Dihosting nirkabel saat ini.

Sintaks

DWORD WlanHostedNetworkQueryStatus(
  [in]  HANDLE                      hClientHandle,
  [out] PWLAN_HOSTED_NETWORK_STATUS *ppWlanHostedNetworkStatus,
        PVOID                       pvReserved
);

Parameter

[in] hClientHandle

Handel sesi klien, dikembalikan oleh panggilan sebelumnya ke fungsi WlanOpenHandle .

[out] ppWlanHostedNetworkStatus

Pada input, parameter ini harus NULL.

Pada output, parameter ini menerima penunjuk ke status Jaringan Yang Dihosting nirkabel saat ini, jika panggilan ke fungsi WlanHostedNetworkQueryStatus berhasil. Status saat ini dikembalikan dalam struktur WLAN_HOSTED_NETWORK_STATUS .

pvReserved

Disiapkan untuk penggunaan masa mendatang. Parameter ini harus NULL.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan mungkin merupakan salah satu kode pengembalian berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_HANDLE	Handel tidak valid. Kesalahan ini dikembalikan jika handel yang ditentukan dalam parameter hClientHandle tidak ditemukan dalam tabel handel.
ERROR_INVALID_PARAMETER	Parameter salah. Kesalahan ini dikembalikan jika salah satu kondisi berikut terjadi: hClientHandle adalah NULL. ppWlanHostedNetworkStatus adalah NULL. pvReserved bukan NULL.
ERROR_INVALID_STATE	Sumber daya tidak dalam status yang benar untuk melakukan operasi yang diminta. Ini dapat terjadi jika Jaringan Yang Dihosting nirkabel sedang dalam proses mematikan.
ERROR_SERVICE_NOT_ACTIVE	Layanan belum dimulai. Kesalahan ini dikembalikan jika Layanan Konfigurasi Otomatis WLAN tidak berjalan.
Lainnya	Berbagai RPC dan kode kesalahan lainnya. Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Fungsi WlanHostedNetworkQueryStatus adalah ekstensi untuk API nirkabel asli yang ditambahkan untuk mendukung Hosted Network nirkabel pada Windows 7 dan pada Windows Server 2008 R2 dengan Layanan LAN Nirkabel diinstal.

Aplikasi klien memanggil fungsi WlanHostedNetworkQueryStatus untuk mengkueri status Jaringan Yang Dihosting nirkabel saat ini. Fungsi ini tidak mengubah status Jaringan Yang Dihosting nirkabel.

Jika fungsi berhasil, parameter ppWlanHostedNetworkStatus menunjuk ke struktur WLAN_HOSTED_NETWORK_STATUS dengan status saat ini. Memori yang digunakan untuk struktur WLAN_HOSTED_NETWORK_STATUS yang dikembalikan harus dibebaskan setelah digunakan dengan memanggil fungsi WlanFreeMemory .

Setiap pengguna dapat memanggil fungsi WlanHostedNetworkQueryStatus untuk mengkueri Jaringan yang Dihosting. Namun, kemampuan untuk mengaktifkan Jaringan Yang Dihosting nirkabel dapat dibatasi oleh kebijakan grup di domain.

Pada Windows 7 dan yang lebih baru, sistem operasi menginstal perangkat virtual jika adaptor nirkabel yang mampu Jaringan Terhosting ada di komputer. Perangkat virtual ini biasanya muncul di "Network Connections Folder" sebagai 'Wireless Network Connection 2' dengan Nama Perangkat 'Adaptor Miniport Microsoft Virtual WiFi' jika komputer memiliki adaptor jaringan nirkabel tunggal. Perangkat virtual ini digunakan secara eksklusif untuk melakukan koneksi titik akses perangkat lunak (SoftAP) dan tidak ada dalam daftar yang dikembalikan oleh fungsi WlanEnumInterfaces . Masa pakai perangkat virtual ini terkait dengan adaptor nirkabel fisik. Jika adaptor nirkabel fisik dinonaktifkan, perangkat virtual ini juga akan dilepas. Fitur ini juga tersedia di Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	wlanapi.h (termasuk Wlanapi.h)
Pustaka	Wlanapi.lib
DLL	Wlanapi.dll