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.

Note Si OpCode a la valeur wlan_intf_opcode_autoconf_enabled, wlan_intf_opcode_background_scan_enabled ou wlan_intf_opcode_media_streaming_mode, pData peut pointer vers une valeur entière. Si pData pointe sur 0, la valeur est convertie en FALSE. Si pData pointe vers un entier différent de zéro, la valeur est convertie en TRUE.
 

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

Voir aussi

À propos du réseau hébergé sans fil

DOT11_BSS_TYPE

WLAN_INTF_OPCODE

WLAN_PHY_RADIO_STATE

WlanQueryInterface