Fonction WlanSetInterface (wlanapi.h)
La fonction WlanSetInterface définit des paramètres configurables par l’utilisateur pour une interface spécifiée.
Syntaxe
DWORD WlanSetInterface(
[in] HANDLE hClientHandle,
[in] const GUID *pInterfaceGuid,
[in] WLAN_INTF_OPCODE OpCode,
[in] DWORD dwDataSize,
[in] const PVOID pData,
PVOID pReserved
);
Paramètres
[in] hClientHandle
Le handle de session du client, obtenu par un appel précédent à la fonction WlanOpenHandle .
[in] pInterfaceGuid
GUID de l’interface à configurer.
[in] OpCode
Valeur WLAN_INTF_OPCODE qui spécifie le paramètre à définir. Le tableau suivant répertorie les constantes valides ainsi que le type de données du paramètre dans pData.
| valeur WLAN_INTF_OPCODE | Type de données pData | Description |
|---|---|---|
| wlan_intf_opcode_autoconf_enabled | BOOL | Active ou désactive la configuration automatique pour l’interface indiquée. |
| wlan_intf_opcode_background_scan_enabled | BOOL | Active ou désactive l’analyse en arrière-plan pour l’interface indiquée. |
| wlan_intf_opcode_radio_state | WLAN_PHY_RADIO_STATE | Définit l’état radio du logiciel d’une couche physique spécifique (PHY) pour l’interface. |
| wlan_intf_opcode_bss_type | DOT11_BSS_TYPE | Définit le type BSS. |
| wlan_intf_opcode_media_streaming_mode | BOOL | Définit le mode de streaming multimédia pour le pilote. |
| wlan_intf_opcode_current_operation_mode | ULONG | Définit le mode de fonctionnement actuel pour l’interface. Pour plus d'informations, consultez la section Notes. |
Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Seules les constantes wlan_intf_opcode_autoconf_enabled et wlan_intf_opcode_bss_type sont valides.
[in] dwDataSize
Taille du paramètre pData , en octets. Si dwDataSize est supérieur à la quantité réelle de mémoire allouée à pData, une violation d’accès se produit dans le programme appelant.
[in] pData
Valeur à définir comme spécifié par le paramètre OpCode . Le type de données pointée par pData doit être approprié pour l’OpCode spécifié. Utilisez le tableau ci-dessus pour déterminer le type de données à utiliser.
pReserved
Réservé pour un usage futur. Doit être défini sur NULL.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour peut être l’un des codes de retour suivants.
Remarques
Lorsque OpCode est défini sur wlan_intf_opcode_current_operation_mode, la fonction WlanSetInterface définit le mode de fonctionnement actuel de l’interface sans fil. Pour plus d’informations sur les modes de fonctionnement, consultez Modes de fonctionnement natifs 802.11. Deux modes d’opération sont pris en charge : DOT11_OPERATION_MODE_EXTENSIBLE_STATION et DOT11_OPERATION_MODE_NETWORK_MONITOR. Les constantes de mode d’opération sont définies dans le fichier d’en-tête Windot11.h. Si pData ne pointe pas vers l’une de ces valeurs lorsque OpCode est défini sur wlan_intf_opcode_current_operation_mode, la fonction WlanSetInterface échoue avec une erreur.
Pour activer ou désactiver le service de configuration automatique sur la ligne de commande, qui équivaut à appeler WlanSetInterface avec OpCode défini sur wlan_intf_opcode_autoconf_enabled, utilisez la commande netsh wlan setautoconfig . Pour plus d’informations, consultez Netsh Commands for Wireless Local Area Network (wlan).
L’état de la radio logicielle peut être modifié en appelant la fonction WlanSetInterface . L’état de la radio matérielle ne peut pas être modifié en appelant la fonction WlanSetInterface . Lorsque le paramètre OpCode est défini sur wlan_intf_opcode_radio_state, la fonction WlanSetInterface définit l’état radio logiciel d’un PHY spécifique. Le paramètre pData doit pointer vers une structure WLAN_PHY_RADIO_STATE avec les nouvelles valeurs d’état radio à utiliser. Le membre dot11HardwareRadioState de la structure WLAN_PHY_RADIO_STATE est ignoré lorsque la fonction WlanSetInterface est appelée avec le paramètre OpCode défini sur wlan_intf_opcode_radio_state et que le paramètre pData pointe vers une structure WLAN_PHY_RADIO_STATE . L’état radio d’un PHY est désactivé si l’état radio du logiciel (membre dot11SoftwareRadioState de la structure WLAN_PHY_RADIO_STATE ) ou l’état radio matériel (membre dot11HardwareRadioState de la structure WLAN_PHY_RADIO_STATE ) est désactivé.
La modification de l’état de la radio logicielle d’une interface réseau physique peut entraîner des modifications connexes dans l’état des états radio du réseau hébergé sans fil ou de l’adaptateur sans fil virtuel. Les PHY de chaque carte sans fil virtuelle sont liées. Pour plus d’informations, consultez À propos du réseau hébergé sans fil.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista, Windows XP avec SP3 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | wlanapi.h (inclure Wlanapi.h) |
| Bibliothèque | Wlanapi.lib |
| DLL | Wlanapi.dll |
| Composant redistribuable | API LAN sans fil pour Windows XP avec SP2 |