WlanSetInterface-Funktion (wlanapi.h)
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.
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 |