Fungsi WlanHostedNetworkInitSettings (wlanapi.h)

Artikel
03/04/2024

Fungsi WlanHostedNetworkInitSettings mengonfigurasi dan bertahan untuk menyimpan pengaturan koneksi jaringan (SSID dan jumlah maksimum peer, misalnya) pada Hosted Network nirkabel jika pengaturan ini belum dikonfigurasi.

Sintaks

DWORD WlanHostedNetworkInitSettings(
  [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 WlanHostedNetworkInitSettings 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
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. pvReserved bukan NULL.
ERROR_INVALID_STATE	Sumber daya tidak dalam status yang benar untuk melakukan operasi yang diminta.
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 WlanHostedNetworkInitSettings 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 WlanHostedNetworkInitSettings untuk mengonfigurasi dan bertahan untuk menyimpan pengaturan koneksi jaringan (SSID dan jumlah maksimum serekan, misalnya) pada Hosted Network nirkabel, jika pengaturan koneksi belum dikonfigurasi. Jika pengaturan jaringan pada pengaturan Hosted Network nirkabel sudah dikonfigurasi (fungsi WlanHostedNetworkQueryProperty tidak mengembalikan ERROR_BAD_CONFIGURATION untuk profil stasiun atau pengaturan koneksi), maka panggilan fungsi ini mengembalikan ERROR_SUCCESS tanpa mengubah konfigurasi pengaturan koneksi jaringan.

Aplikasi klien harus selalu memanggil fungsi WlanHostedNetworkInitSettings sebelum menggunakan fitur Jaringan Yang Dihosting lainnya di komputer lokal. Fungsi ini menginisialisasi pengaturan yang diperlukan ketika Jaringan Yang Dihosting nirkabel digunakan untuk pertama kalinya pada komputer lokal. Fungsi WlanHostedNetworkInitSettings tidak mengubah konfigurasi apa pun jika konfigurasi telah dipertahankan. Jadi aman untuk memanggil fungsi WlanHostedNetworkInitSettings jika konfigurasi telah dipertahankan. Disarankan agar aplikasi yang menggunakan Hosted Network memanggil fungsi WlanHostedNetworkInitSettings sebelum menggunakan fungsi Jaringan Yang Dihosting lainnya.

Fungsi WlanHostedNetworkInitSettings menghitung SSID acak dan dapat dibaca dari nama host dan menghitung kunci primer acak. Fungsi ini juga menggunakan menetapkan nilai untuk jumlah maksimum rekan yang diizinkan yang default ke 100. Jika aplikasi ingin menggunakan SSID yang berbeda atau jumlah maksimum rekan yang berbeda, maka aplikasi harus memanggil fungsi WlanHostedNetworkSetProperty untuk secara khusus mengatur properti ini yang digunakan oleh Hosted Network nirkabel.

Setiap perubahan status 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.

Setiap pengguna dapat memanggil fungsi WlanHostedNetworkInitSettings untuk mengonfigurasi dan bertahan ke pengaturan koneksi jaringan penyimpanan di Jaringan yang Dihosting. Jika Jaringan Hosted nirkabel telah dikonfigurasi, fungsi ini tidak melakukan apa pun dan mengembalikan ERROR_SUCCESS.

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