Fungsi WlanHostedNetworkSetProperty (wlanapi.h)

Artikel
03/15/2023

Fungsi WlanHostedNetworkSetProperty menetapkan properti statis dari Hosted Network nirkabel.

Sintaks

DWORD WlanHostedNetworkSetProperty(
  [in]            HANDLE                      hClientHandle,
  [in]            WLAN_HOSTED_NETWORK_OPCODE  OpCode,
  [in]            DWORD                       dwDataSize,
  [in]            PVOID                       pvData,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

Parameter

[in] hClientHandle

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

[in] OpCode

Pengidentifikasi untuk properti yang akan diatur. Pengidentifikasi ini hanya dapat menjadi nilai berikut dalam enumerasi WLAN_HOSTED_NETWORK_OPCODE yang ditentukan dalam file header Wlanapi.h :

wlan_hosted_network_opcode_connection_settings

Pengaturan koneksi Jaringan yang Dihosting.

wlan_hosted_network_opcode_enable

Bendera jaringan yang diaktifkan Hosted Network.

[in] dwDataSize

Nilai yang menentukan ukuran, dalam byte, dari buffer yang diacu oleh parameter pvData .

[in] pvData

Penunjuk ke buffer dengan properti statis untuk diatur. Jenis data yang terkait dengan buffer ini tergantung pada nilai parameter OpCode .

[out, optional] pFailReason

Penunjuk opsional ke nilai yang menerima alasan kegagalan, jika panggilan ke fungsi WlanHostedNetworkSetProperty gagal. Nilai yang mungkin karena alasan kegagalan berasal dari jenis enumerasi WLAN_HOSTED_NETWORK_REASON yang ditentukan dalam file header Wlanapi.h .

pvReserved

Disiapkan untuk penggunaan masa mendatang. Parameter ini harus NULL.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

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

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki izin yang memadai. Kesalahan ini juga dikembalikan jika parameter OpCodewlan_hosted_network_opcode_enable dan Jaringan yang Dihosting nirkabel dinonaktifkan oleh kebijakan grup pada domain.
ERROR_BAD_PROFILE	Profil koneksi jaringan yang digunakan oleh Jaringan Yang Dihosting nirkabel rusak.
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. dwDataSize adalah nol. pvData adalah NULL. pvData tidak menunjuk ke properti statis yang terbentuk dengan baik. 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_NOT_SUPPORTED	Permintaan tidak didukung. Kesalahan ini dikembalikan jika aplikasi memanggil fungsi WlanHostedNetworkSetProperty dengan parameter OpCode diatur ke wlan_hosted_network_opcode_station_profile atau wlan_hosted_network_opcode_security_settings.
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 WlanHostedNetworkSetProperty 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 terinstal.

Aplikasi klien memanggil fungsi WlanHostedNetworkSetProperty untuk mengatur properti statis saat ini dari Hosted Network nirkabel. Setiap perubahan properti Jaringan yang Dihosting yang disebabkan oleh fungsi ini tidak akan secara otomatis dibatalkan jika aplikasi panggilan menutup handel panggilannya (dengan memanggil WlanCloseHandle dengan parameter hClientHandle ) atau jika proses berakhir.

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

Opcode	Deskripsi
wlan_hosted_network_opcode_connection_settings	Penunjuk ke struktur WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS diteruskan dalam parameter pvData .
wlan_hosted_network_opcode_enable	Pointer ke BOOL diteruskan dalam parameter pvData .

Jika fungsi WlanHostedNetworkSetProperty dipanggil dengan parameter OpCode yang diatur ke wlan_hosted_network_opcode_enable, pengguna harus memiliki hak istimewa terkait yang sesuai. Izin disimpan dalam daftar kontrol akses diskresi (DACL) yang terkait dengan WLAN_SECURABLE_OBJECT. Untuk memanggil fungsi WlanHostedNetworkSetProperty dengan parameter OpCodewlan_hosted_network_opcode_enable, token akses klien pemanggil harus memiliki hak istimewa yang ditingkatkan yang diekspos oleh enumerasi berikut di WLAN_SECURABLE_OBJECT:

wlan_secure_hosted_network_elevated_access

Jika fungsi WlanHostedNetworkSetProperty melewati salah satu nilai berikut dalam parameter OpCode , fungsi akan gagal dengan ERROR_NOT_SUPPORTED:

wlan_hosted_network_opcode_station_profile
wlan_hosted_network_opcode_connection_settings

Agar berhasil, fungsi WlanHostedNetworkSetProperty harus mempertahankan pengaturan baru yang mengharuskan status Jaringan yang Dihosting ditransisikan ke wlan_hosted_network_idle jika saat ini berjalan (wlan_hosted_network_active).

Setiap pengguna dapat memanggil fungsi ini untuk mengatur properti Jaringan yang Dihosting. Namun, untuk mengatur bendera wlan_hosted_network_opcode_enable memerlukan hak istimewa yang ditingkatkan. Kemampuan untuk mengaktifkan Jaringan Yang Dihosting nirkabel juga 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 pada komputer. Perangkat virtual ini biasanya muncul di "Folder Connections Jaringan" sebagai 'Koneksi Jaringan Nirkabel 2' dengan Nama Perangkat 'Adaptor Mini WiFi Virtual Microsoft' 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 dihapus. 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