Fungsi WlanSetInterface (wlanapi.h)

Artikel
03/09/2024

Fungsi WlanSetInterface mengatur parameter yang dapat dikonfigurasi pengguna untuk antarmuka tertentu.

Sintaks

DWORD WlanSetInterface(
  [in] HANDLE           hClientHandle,
  [in] const GUID       *pInterfaceGuid,
  [in] WLAN_INTF_OPCODE OpCode,
  [in] DWORD            dwDataSize,
  [in] const PVOID      pData,
       PVOID            pReserved
);

Parameter

[in] hClientHandle

Handel sesi klien, diperoleh dengan panggilan sebelumnya ke fungsi WlanOpenHandle .

[in] pInterfaceGuid

GUID antarmuka yang akan dikonfigurasi.

[in] OpCode

Nilai WLAN_INTF_OPCODE yang menentukan parameter yang akan ditetapkan. Tabel berikut mencantumkan konstanta yang valid bersama dengan jenis data parameter dalam pData.

nilai WLAN_INTF_OPCODE	Jenis data pData	Deskripsi
wlan_intf_opcode_autoconf_enabled	BOOL	Mengaktifkan atau menonaktifkan konfigurasi otomatis untuk antarmuka yang ditunjukkan.
wlan_intf_opcode_background_scan_enabled	BOOL	Mengaktifkan atau menonaktifkan pemindaian latar belakang untuk antarmuka yang ditunjukkan.
wlan_intf_opcode_radio_state	WLAN_PHY_RADIO_STATE	Mengatur status radio perangkat lunak dari lapisan fisik (PHY) tertentu untuk antarmuka.
wlan_intf_opcode_bss_type	DOT11_BSS_TYPE	Mengatur jenis BSS.
wlan_intf_opcode_media_streaming_mode	BOOL	Menyetel mode streaming media untuk driver.
wlan_intf_opcode_current_operation_mode	ULONG	Mengatur mode operasi saat ini untuk antarmuka. Untuk informasi selengkapnya, lihat Keterangan.

Windows XP dengan SP3 dan WIRELESS LAN API untuk Windows XP dengan SP2: Hanya konstanta wlan_intf_opcode_autoconf_enabled dan wlan_intf_opcode_bss_type yang valid.

[in] dwDataSize

Ukuran parameter pData , dalam byte. Jika dwDataSize lebih besar dari jumlah memori aktual yang dialokasikan untuk pData, maka pelanggaran akses akan terjadi dalam program panggilan.

[in] pData

Nilai yang akan ditetapkan sebagaimana ditentukan oleh parameter OpCode . Jenis data yang diacu oleh pData harus sesuai untuk OpCode yang ditentukan. Gunakan tabel di atas untuk menentukan jenis data yang akan digunakan.

Catatan Jika OpCode diatur ke wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled, atau wlan_intf_opcode_media_streaming_mode, maka pData dapat menunjuk ke nilai bilangan bulat. Jika pData menunjuk ke 0, maka nilai dikonversi ke FALSE. Jika pData menunjuk ke bilangan bulat bukan nol, maka nilai dikonversi ke TRUE.

pReserved

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

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

Keterangan

Ketika OpCode diatur ke wlan_intf_opcode_current_operation_mode, fungsi WlanSetInterface mengatur mode operasi antarmuka nirkabel saat ini. Untuk informasi selengkapnya tentang mode operasi, lihat Mode Operasi Native 802.11. Dua mode operasi didukung: DOT11_OPERATION_MODE_EXTENSIBLE_STATION dan DOT11_OPERATION_MODE_NETWORK_MONITOR. Konstanta mode operasi ditentukan dalam file header Windot11.h. Jika pData tidak menunjuk ke salah satu nilai ini ketika OpCode diatur ke wlan_intf_opcode_current_operation_mode, fungsi WlanSetInterface akan gagal dengan kesalahan.

Untuk mengaktifkan atau menonaktifkan layanan konfigurasi otomatis di baris perintah, yang secara fungsional setara dengan memanggil WlanSetInterface dengan OpCode diatur ke wlan_intf_opcode_autoconf_enabled, gunakan perintah netsh wlan setautoconfig . Untuk informasi selengkapnya, lihat Perintah Netsh untuk Jaringan Area Lokal Nirkabel (wlan).

Status radio perangkat lunak dapat diubah dengan memanggil fungsi WlanSetInterface . Status radio perangkat keras tidak dapat diubah dengan memanggil fungsi WlanSetInterface . Ketika parameter OpCode diatur ke wlan_intf_opcode_radio_state, fungsi WlanSetInterface mengatur status radio perangkat lunak dari PHY tertentu. Parameter pData harus menunjuk ke struktur WLAN_PHY_RADIO_STATE dengan nilai status radio baru untuk digunakan. Anggota dot11HardwareRadioState dari struktur WLAN_PHY_RADIO_STATE diabaikan ketika fungsi WlanSetInterface dipanggil dengan parameter OpCode yang diatur ke wlan_intf_opcode_radio_state dan parameter pData menunjuk ke struktur WLAN_PHY_RADIO_STATE . Status radio PHY nonaktif jika status radio perangkat lunak (anggota dot11SoftwareRadioState dari struktur WLAN_PHY_RADIO_STATE ) atau status radio perangkat keras (anggota dot11HardwareRadioState dari struktur WLAN_PHY_RADIO_STATE ) nonaktif.

Mengubah status radio perangkat lunak antarmuka jaringan fisik dapat menyebabkan perubahan terkait dalam status Jaringan Yang Dihosting nirkabel atau status radio adaptor nirkabel virtual. PHY dari setiap adaptor nirkabel virtual ditautkan. Untuk informasi selengkapnya, lihat Tentang Jaringan yang Dihosting Nirkabel.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wlanapi.h (termasuk Wlanapi.h)
Pustaka	Wlanapi.lib
DLL	Wlanapi.dll
Redistribusi	API LAN Nirkabel untuk Windows XP dengan SP2

Lihat juga

Tentang Jaringan yang Dihosting Nirkabel