WlanSetInterface-Funktion (wlanapi.h)

Artikel
08/28/2023

Die WlanSetInterface-Funktion legt benutzerdefinierte Parameter für eine angegebene Schnittstelle fest.

Syntax

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

Das Sitzungshandle des Clients, das durch einen vorherigen Aufruf der WlanOpenHandle-Funktion abgerufen wurde.

[in] pInterfaceGuid

Die GUID der zu konfigurierenden Schnittstelle.

[in] OpCode

Ein WLAN_INTF_OPCODE Wert, der den festzulegenden Parameter angibt. In der folgenden Tabelle sind die gültigen Konstanten zusammen mit dem Datentyp des Parameters in pData aufgeführt.

WLAN_INTF_OPCODE Wert	pData-Datentyp	BESCHREIBUNG
wlan_intf_opcode_autoconf_enabled	BOOL	Aktiviert oder deaktiviert die automatische Konfiguration für die angegebene Schnittstelle.
wlan_intf_opcode_background_scan_enabled	BOOL	Aktiviert oder deaktiviert die Hintergrundüberprüfung für die angegebene Schnittstelle.
wlan_intf_opcode_radio_state	WLAN_PHY_RADIO_STATE	Legt den Softwarefunkstatus einer bestimmten physischen Schicht (PHY) für die Schnittstelle fest.
wlan_intf_opcode_bss_type	DOT11_BSS_TYPE	Legt den BSS-Typ fest.
wlan_intf_opcode_media_streaming_mode	BOOL	Legt den Medienstreamingmodus für den Treiber fest.
wlan_intf_opcode_current_operation_mode	ULONG	Legt den aktuellen Betriebsmodus für die Schnittstelle fest. Weitere Informationen finden Sie in den Hinweisen.

Windows XP mit SP3 und WLAN-API für Windows XP mit SP2: Nur die konstanten wlan_intf_opcode_autoconf_enabled und wlan_intf_opcode_bss_type sind gültig.

[in] dwDataSize

Die Größe des pData-Parameters in Bytes. Wenn dwDataSize größer als die tatsächliche Menge an Arbeitsspeicher ist, die pData zugewiesen ist, tritt im aufrufenden Programm eine Zugriffsverletzung auf.

[in] pData

Der wert, der gemäß dem OpCode-Parameter festgelegt werden soll. Der Datentyp, auf den pData verweist, muss für den angegebenen OpCode geeignet sein. Verwenden Sie die obige Tabelle, um den Typ der zu verwendenden Daten zu bestimmen.

Hinweis Wenn OpCode auf wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled oder wlan_intf_opcode_media_streaming_mode festgelegt ist, kann pData auf einen ganzzahligen Wert verweisen. Wenn pData auf 0 zeigt, wird der Wert in FALSE konvertiert. Wenn pData auf eine ganze Zahl ohne Zero verweist, wird der Wert in TRUE konvertiert.

pReserved

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Hinweise

Wenn OpCode auf wlan_intf_opcode_current_operation_mode festgelegt ist, legt die WlanSetInterface-Funktion den aktuellen Betriebsmodus der Drahtlosen Schnittstelle fest. Weitere Informationen zu Betriebsmodi finden Sie unter Native 802.11-Betriebsmodi. Zwei Betriebsmodi werden unterstützt: DOT11_OPERATION_MODE_EXTENSIBLE_STATION und DOT11_OPERATION_MODE_NETWORK_MONITOR. Die Betriebsmoduskonstanten sind in der Headerdatei Windot11.h definiert. Wenn pData nicht auf einen dieser Werte verweist, wenn OpCode auf wlan_intf_opcode_current_operation_mode festgelegt ist, schlägt die WlanSetInterface-Funktion mit einem Fehler fehl.

Verwenden Sie den Befehl netsh wlan setautoconfig, um den automatischen Konfigurationsdienst an der Befehlszeile zu aktivieren oder zu deaktivieren, der funktional dem Aufrufen von WlanSetInterface entspricht, wobei OpCode auf wlan_intf_opcode_autoconf_enabled festgelegt ist. Weitere Informationen finden Sie unter Netsh Commands for Wireless Local Area Network (WLAN).

Der Softwarefunkzustand kann durch Aufrufen der WlanSetInterface-Funktion geändert werden. Der Hardwarefunkzustand kann nicht durch Aufrufen der WlanSetInterface-Funktion geändert werden. Wenn der OpCode-Parameter auf wlan_intf_opcode_radio_state festgelegt ist, legt die WlanSetInterface-Funktion den Softwarefunkstatus eines bestimmten PHY fest. Der pData-Parameter muss auf eine WLAN_PHY_RADIO_STATE-Struktur mit den zu verwendenden neuen Funkzustandswerten verweisen. Das dot11HardwareRadioState-Element der WLAN_PHY_RADIO_STATE-Struktur wird ignoriert, wenn die WlanSetInterface-Funktion aufgerufen wird, wobei der OpCode-Parameter auf wlan_intf_opcode_radio_state festgelegt ist und der pData-Parameter auf eine WLAN_PHY_RADIO_STATE-Struktur verweist. Der Funkstatus eines PHY ist deaktiviert, wenn entweder der Softwarefunkstatus (dot11SoftwareRadioState-Member der WLAN_PHY_RADIO_STATE-Struktur ) oder der Hardwarefunkzustand (dot11HardwareRadioState-Member der WLAN_PHY_RADIO_STATE-Struktur ) deaktiviert ist.

Das Ändern des Softwarefunkzustands einer physischen Netzwerkschnittstelle kann zu entsprechenden Änderungen im Zustand des funkinternen gehosteten Netzwerks oder des virtuellen Drahtlosadapters führen. Die PHYs jedes virtuellen Drahtlosadapters sind verknüpft. Weitere Informationen finden Sie unter Informationen zum gehosteten Drahtlosnetzwerk.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wlanapi.h (einschließlich Wlanapi.h)
Bibliothek	Wlanapi.lib
DLL	Wlanapi.dll
Verteilbare Komponente	Wlan-API für Windows XP mit SP2

Weitere Informationen

Informationen zum drahtlos gehosteten Netzwerk