Fungsi WlanHostedNetworkQueryProperty (wlanapi.h)

Artikel
08/28/2023

Fungsi WlanHostedNetworkQueryProperty meminta properti statis saat ini dari Hosted Network nirkabel.

Sintaks

DWORD WlanHostedNetworkQueryProperty(
  [in]  HANDLE                     hClientHandle,
  [in]  WLAN_HOSTED_NETWORK_OPCODE OpCode,
  [out] PDWORD                     pdwDataSize,
  [out] PVOID                      *ppvData,
  [out] PWLAN_OPCODE_VALUE_TYPE    pWlanOpcodeValueType,
        PVOID                      pvReserved
);

Parameter

[in] hClientHandle

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

[in] OpCode

Pengidentifikasi untuk properti yang akan dikueri. Pengidentifikasi ini dapat menjadi salah satu nilai dalam enumerasi WLAN_HOSTED_NETWORK_OPCODE yang ditentukan dalam file header Wlanapi.h .

[out] pdwDataSize

Penunjuk ke nilai yang menentukan ukuran, dalam byte, dari buffer yang dikembalikan dalam parameter ppvData , jika panggilan ke fungsi WlanHostedNetworkQueryProperty berhasil.

[out] ppvData

Pada input, parameter ini harus NULL.

Pada output, parameter ini menerima pointer ke buffer yang dikembalikan dengan properti statis yang diminta, jika panggilan ke fungsi WlanHostedNetworkQueryProperty berhasil. Jenis data yang terkait dengan buffer ini tergantung pada nilai parameter OpCode .

[out] pWlanOpcodeValueType

Pointer ke nilai yang menerima jenis nilai properti Hosted Network nirkabel, jika panggilan ke fungsi WlanHostedNetworkQueryProperty berhasil. Nilai yang dikembalikan adalah jenis enumerasi dalam enumerasi WLAN_OPCODE_VALUE_TYPE yang ditentukan dalam file header Wlanapi.h .

pvReserved

Disiapkan untuk penggunaan masa mendatang. Parameter ini harus NULL.

Nilai kembali

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_BAD_CONFIGURATION	Data konfigurasi untuk Hosted Network nirkabel tidak dikonfigurasi. Kesalahan ini dikembalikan jika aplikasi memanggil fungsi WlanHostedNetworkQueryProperty dengan parameter OpCode diatur ke wlan_hosted_network_opcode_station_profile atau wlan_hosted_network_opcode_connection_settings sebelum SSID dikonfigurasi di Hosted Network nirkabel.
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. OpCode bukan salah satu nilai enumerasi yang ditentukan dalam WLAN_HOSTED_NETWORK_OPCODE. pdwDataSize adalah NULL. ppvData adalah NULL. pWlanOpcodeValueType 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_OUTOFMEMORY	Penyimpanan yang tersedia tidak cukup untuk menyelesaikan operasi ini.
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 WlanHostedNetworkQueryProperty 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 WlanHostedNetworkQueryProperty untuk mengkueri properti statis saat ini dari Hosted Network nirkabel. Fungsi ini tidak mengubah status atau properti Jaringan Yang Dihosting nirkabel.

Jika fungsi berhasil, parameter ppvData menunjuk ke buffer yang berisi properti yang diminta. Ukuran buffer ini dikembalikan dalam pointer yang dikembalikan dalam parameter pwdDataSize . WLAN_OPCODE_VALUE_TYPE dikembalikan dalam pointer yang dikembalikan dalam parameter pWlanOpcodeValueType. Memori yang digunakan untuk buffer dalam parameter ppvData yang dikembalikan harus dirilis dengan memanggil fungsi WlanFreeMemory setelah buffer tidak lagi diperlukan.

Jenis data yang terkait dengan buffer yang diacu oleh parameter ppvData tergantung pada nilai parameter OpCode sebagai berikut:

Opcode	Deskripsi
wlan_hosted_network_opcode_connection_settings	Penunjuk ke struktur WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS dikembalikan.
wlan_hosted_network_opcode_security_settings	Penunjuk ke struktur WLAN_HOSTED_NETWORK_SECURITY_SETTINGS dikembalikan.
wlan_hosted_network_opcode_station_profile	PWSTR untuk memuat profil XML WLAN untuk menyambungkan ke Jaringan Yang Dihosting nirkabel dikembalikan.
wlan_hosted_network_opcode_enable	PBOOL yang menunjukkan apakah Jaringan Hosted nirkabel diaktifkan dikembalikan.

Jika fungsi WlanHostedNetworkQueryProperty melewati salah satu nilai berikut dalam parameter OpCode sebelum SSID dikonfigurasi di Hosted Network nirkabel, fungsi akan gagal dengan ERROR_BAD_CONFIGURATION:

wlan_hosted_network_opcode_station_profile
wlan_hosted_network_opcode_connection_settings

Setiap pengguna dapat memanggil fungsi WlanHostedNetworkQueryProperty untuk mengkueri properti Jaringan yang Dihosting.

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