Fungsi WlanHostedNetworkRefreshSecuritySettings (wlanapi.h)
Fungsi WlanHostedNetworkRefreshSecuritySettings menyegarkan bagian yang dapat dikonfigurasi dan dihasilkan secara otomatis dari pengaturan keamanan Hosted Network nirkabel.
Sintaks
DWORD WlanHostedNetworkRefreshSecuritySettings(
[in] HANDLE hClientHandle,
[out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
PVOID pvReserved
);
Parameter
[in] hClientHandle
Handel sesi klien, dikembalikan oleh panggilan sebelumnya ke fungsi WlanOpenHandle .
[out, optional] pFailReason
Penunjuk opsional ke nilai yang menerima alasan kegagalan, jika panggilan ke fungsi WlanHostedNetworkRefreshSecuritySettings 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 adalah ERROR_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan mungkin merupakan salah satu kode pengembalian berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Handel tidak valid. Kesalahan ini dikembalikan jika handel yang ditentukan dalam parameter hClientHandle tidak ditemukan dalam tabel handel. |
|
Parameter salah. Kesalahan ini dikembalikan jika salah satu kondisi berikut terjadi:
|
|
Sumber daya tidak dalam status yang benar untuk melakukan operasi yang diminta. |
|
Layanan belum dimulai. Kesalahan ini dikembalikan jika Layanan Konfigurasi Otomatis WLAN tidak berjalan. |
|
Berbagai RPC dan kode kesalahan lainnya. Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
Fungsi WlanHostedNetworkRefreshSecuritySettings 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 WlanHostedNetworkRefreshSecuritySettings untuk memaksa refresh bagian pengaturan keamanan yang dapat dikonfigurasi dan dibuat secara otomatis (kunci utama) pada Hosted Network nirkabel.
Aplikasi mungkin memanggil fungsi WlanHostedNetworkRefreshSecuritySettings setelah memastikan bahwa pengguna menerima dampak pembaruan pengaturan keamanan. Agar berhasil, fungsi ini harus mempertahankan pengaturan baru yang akan mengharuskan status Jaringan yang Dihosting ditransisikan ke wlan_hosted_network_idle jika saat ini sedang berjalan (wlan_hosted_network_active).
Setiap pengguna dapat memanggil fungsi WlanHostedNetworkRefreshSecuritySettings untuk menyegarkan pengaturan keamanan di 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 |
Lihat juga
Tentang Jaringan yang Dihosting Nirkabel
Menggunakan Jaringan yang Dihosting Nirkabel dan Bagi-pakai Sambungan Internet
WlanHostedNetworkQueryProperty
WlanHostedNetworkRefreshSecuritySettings
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk