Funzione WlanSetInterface (wlanapi.h)

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.

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.

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

Vedi anche

Informazioni sulla rete ospitata wireless

DOT11_BSS_TYPE

WLAN_INTF_OPCODE

WLAN_PHY_RADIO_STATE

WlanQueryInterface