Fungsi WlanHostedNetworkForceStart (wlanapi.h)

Artikel
08/28/2023

Fungsi WlanHostedNetworkForceStart mentransisikan Hosted Network nirkabel ke status wlan_hosted_network_active tanpa mengaitkan permintaan dengan handel panggilan aplikasi.

Sintaks

DWORD WlanHostedNetworkForceStart(
  [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 WlanHostedNetworkForceStart 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.

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_ACCESS_DENIED	Pemanggil tidak memiliki izin yang memadai.
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. Kesalahan ini dikembalikan jika Jaringan Yang Dihosting nirkabel dinonaktifkan oleh kebijakan grup pada domain.
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 WlanHostedNetworkForceStart 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 WlanHostedNetworkForceStart untuk memaksa dimulainya Hosted Network nirkabel dengan mentransisikan Hosted Network nirkabel ke status wlan_hosted_network_active tanpa mengaitkan permintaan dengan handel panggilan aplikasi. Panggilan yang berhasil ke fungsi WlanHostedNetworkForceStart akhirnya harus dicocokkan dengan panggilan ke fungsi WlanHostedNetworkForceStop . 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.

Biaya panggilan fungsi WlanHostedNetworkForceStart daripada memanggil WlanHostedNetworkStartUsing adalah hak istimewa terkait yang diperlukan. Aplikasi mungkin memanggil fungsi WlanHostedNetworkForceStart setelah memastikan bahwa pengguna sistem yang ditinggikan menerima peningkatan persyaratan daya yang terlibat dalam menjalankan Hosted Network nirkabel untuk durasi yang diperpanjang.

Fungsi WlanHostedNetworkForceStart dapat gagal jika status Jaringan yang Dihosting wlan_hosted_network_unavailable atau pemanggil tidak memiliki hak istimewa yang memadai.

Fungsi ini untuk memaksa dimulainya Jaringan yang Dihosting hanya dapat dipanggil jika pengguna memiliki hak istimewa terkait yang sesuai. Izin disimpan dalam daftar kontrol akses diskresi (DACL) yang terkait dengan WLAN_SECURABLE_OBJECT. Untuk memanggil WlanHostedNetworkForceStart, token akses klien pemanggil harus memiliki hak istimewa yang ditingkatkan yang diekspos oleh enumerasi berikut dalam WLAN_SECURABLE_OBJECT:

wlan_secure_hosted_network_elevated_access

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 di komputer. Perangkat virtual ini biasanya muncul di "Folder Koneksi 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 dilepas. Fitur ini juga tersedia di Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal.

Persyaratan


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