Funzione WlanSetInterface (wlanapi.h)

Articolo
03/09/2024

La funzione WlanSetInterface imposta i parametri configurabili dall'utente per un'interfaccia specificata.

Sintassi

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

Parametri

[in] hClientHandle

Handle di sessione del client, ottenuto da una chiamata precedente alla funzione WlanOpenHandle .

[in] pInterfaceGuid

GUID dell'interfaccia da configurare.

[in] OpCode

Valore WLAN_INTF_OPCODE che specifica il parametro da impostare. Nella tabella seguente sono elencate le costanti valide insieme al tipo di dati del parametro in pData.

valore WLAN_INTF_OPCODE	Tipo di dati pData	Descrizione
wlan_intf_opcode_autoconf_enabled	BOOL	Abilita o disabilita la configurazione automatica per l'interfaccia indicata.
wlan_intf_opcode_background_scan_enabled	BOOL	Abilita o disabilita l'analisi in background per l'interfaccia indicata.
wlan_intf_opcode_radio_state	WLAN_PHY_RADIO_STATE	Imposta lo stato di radio software di un livello fisico specifico (PHY) per l'interfaccia.
wlan_intf_opcode_bss_type	DOT11_BSS_TYPE	Imposta il tipo BSS.
wlan_intf_opcode_media_streaming_mode	BOOL	Imposta la modalità di streaming multimediale per il driver.
wlan_intf_opcode_current_operation_mode	ULONG	Imposta la modalità operativa corrente per l'interfaccia. Per altre informazioni, vedere la sezione Osservazioni.

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: Sono valide solo le costanti wlan_intf_opcode_autoconf_enabled e wlan_intf_opcode_bss_type .

[in] dwDataSize

Dimensioni del parametro pData , in byte. Se dwDataSize è maggiore della quantità effettiva di memoria allocata a pData, si verificherà una violazione di accesso nel programma chiamante.

[in] pData

Valore da impostare come specificato dal parametro OpCode . Il tipo di dati a cui punta pData deve essere appropriato per il codice OpCode specificato. Usare la tabella precedente per determinare il tipo di dati da usare.

Nota Se OpCode è impostato su wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled o wlan_intf_opcode_media_streaming_mode, pData può puntare a un valore intero. Se pData punta a 0, il valore viene convertito in FALSE. Se pData punta a un numero intero diverso da zero, il valore viene convertito in TRUE.

pReserved

Riservato per utilizzi futuri. Deve essere impostato su NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici restituiti seguenti.

Commenti

Quando OpCode è impostato su wlan_intf_opcode_current_operation_mode, la funzione WlanSetInterface imposta la modalità operativa corrente dell'interfaccia wireless. Per altre informazioni sulle modalità operative, vedere Modalità operative native 802.11. Sono supportate due modalità operative: DOT11_OPERATION_MODE_EXTENSIBLE_STATION e DOT11_OPERATION_MODE_NETWORK_MONITOR. Le costanti della modalità operazione sono definite nel file di intestazione Windot11.h. Se pData non punta a uno di questi valori quando OpCode è impostato su wlan_intf_opcode_current_operation_mode, la funzione WlanSetInterface avrà esito negativo con un errore.

Per abilitare o disabilitare il servizio di configurazione automatica nella riga di comando, che equivale dal punto di vista funzionale alla chiamata a WlanSetInterface con OpCode impostato su wlan_intf_opcode_autoconf_enabled, usare il comando netsh wlan setautoconfig . Per altre informazioni, vedere Netsh Commands for Wireless Local Area Network (wlan).For more information, see Netsh Commands for Wireless Local Area Network (wlan).

Lo stato di radio software può essere modificato chiamando la funzione WlanSetInterface . Non è possibile modificare lo stato di radio hardware chiamando la funzione WlanSetInterface . Quando il parametro OpCode è impostato su wlan_intf_opcode_radio_state, la funzione WlanSetInterface imposta lo stato di radio software di un PHY specifico. Il parametro pData deve puntare a una struttura WLAN_PHY_RADIO_STATE con i nuovi valori dello stato di opzione da usare. Il membro dot11HardwareRadioState della struttura WLAN_PHY_RADIO_STATE viene ignorato quando la funzione WlanSetInterface viene chiamata con il parametro OpCode impostato su wlan_intf_opcode_radio_state e il parametro pData punta a una struttura WLAN_PHY_RADIO_STATE . Lo stato di radio di un PHY è disattivato se lo stato della radio software (membro dot11SoftwareRadioState della struttura WLAN_PHY_RADIO_STATE ) o lo stato di radio hardware (dot11HardwareRadioState membro della struttura WLAN_PHY_RADIO_STATE ) è disattivato.

La modifica dello stato radio software di un'interfaccia di rete fisica potrebbe causare modifiche correlate allo stato della rete ospitata wireless o degli stati di radio della scheda wireless virtuale. I PHY di ogni scheda wireless virtuale sono collegati. Per altre informazioni, vedere Informazioni sulla rete ospitata wireless.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wlanapi.h (include Wlanapi.h)
Libreria	Wlanapi.lib
DLL	Wlanapi.dll
Componente ridistribuibile	API LAN wireless per Windows XP con SP2