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.

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

Voir aussi

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

DOT11_BSS_TYPE

WLAN_INTF_OPCODE

WLAN_PHY_RADIO_STATE

WlanQueryInterface