Fonction WlanSetAutoConfigParameter (wlanapi.h)

Article
08/28/2023

La fonction WlanSetAutoConfigParameter définit les paramètres du service de configuration automatique.

Syntaxe

DWORD WlanSetAutoConfigParameter(
  [in] HANDLE               hClientHandle,
  [in] WLAN_AUTOCONF_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] OpCode

Valeur WLAN_AUTOCONF_OPCODE qui spécifie le paramètre à définir. Seuls certains des opcodes de l’énumération WLAN_AUTOCONF_OPCODE prennent en charge les opérations de jeu.

Valeur	Signification
wlan_autoconf_opcode_show_denied_networks	Lorsqu’il est défini, le paramètre pData contient une valeur BOOL indiquant si les réseaux refusés par l’utilisateur et les stratégies de groupe seront inclus dans la liste des réseaux disponibles.
wlan_autoconf_opcode_allow_explicit_creds	Lorsqu’il est défini, le paramètre pData contient une valeur BOOL indiquant si l’interface sans fil actuelle a des informations d’identification utilisateur partagées autorisées.
wlan_autoconf_opcode_block_period	Lorsqu’il est défini, le paramètre pData contient une valeur DWORD pour le paramètre de période bloquée pour l’interface sans fil actuelle. La période bloquée correspond à la durée, en secondes, pendant laquelle la connexion automatique à un réseau sans fil ne sera pas tentée après une défaillance précédente.
wlan_autoconf_opcode_allow_virtual_station_extensibility	Lorsqu’il est défini, le paramètre pData contient une valeur BOOL indiquant si l’extensibilité sur une station virtuelle est autorisée. Par défaut, l’extensibilité sur une station virtuelle est autorisée. La valeur de cet opcode est conservée entre les redémarrages. Cette valeur d’énumération est prise en charge sur Windows 7 et Windows Server 2008 R2 avec le service LAN sans fil installé.

[in] dwDataSize

Taille du paramètre pData , en octets. Ce paramètre doit être défini sur sizeof(BOOL) pour un BOOL ou sizeof(DWORD) pour un DWORD, en fonction de la valeur du paramètre OpCode .

[in] pData

Valeur à définir pour le paramètre spécifié dans le paramètre OpCode . Le paramètre pData doit pointer vers une valeur booléenne ou DWORD, en fonction de la valeur du paramètre OpCode . Le paramètre pData ne doit pas avoir la valeur NULL.

Note Le paramètre pData peut pointer vers une valeur entière lorsqu’une valeur booléenne est requise. 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.

Code de retour	Description
ERROR_ACCESS_DENIED	L’accès est refusé. Cette erreur est retournée si l’appelant ne dispose pas des autorisations suffisantes pour définir le paramètre de configuration lorsque le paramètre OpCode est wlan_autoconf_opcode_show_denied_networks ou wlan_autoconf_opcode_allow_virtual_station_extensibility. Lorsque le paramètre OpCode est défini sur l’une de ces valeurs, la fonction WlanSetAutoConfigParameter récupère la liste de contrôle d’accès discrétionnaire (DACL) stockée pour l’objet opcode. Si la liste de contrôle d’accès ne contient pas d’entrée de contrôle d’accès (ACE) qui accorde à WLAN_WRITE_ACCESS l’autorisation d’accès au jeton d’accès du thread appelant, WlanSetAutoConfigParameter retourne ERROR_ACCESS_DENIED. Cette erreur est également retournée si le paramètre de configuration est défini par la stratégie de groupe sur un domaine. Lorsque la stratégie de groupe est définie pour un opcode, les applications ne peuvent pas apporter de modifications. Pour les paramètres OpCode suivants peuvent être définis par stratégie de groupe : wlan_autoconf_opcode_show_denied_networks, wlan_autoconf_opcode_allow_explicit_creds et wlan_autoconf_opcode_block_period
ERROR_INVALID_PARAMETER	Un paramètre était incorrect. Cette erreur est retournée si le paramètre hClientHandle a la valeur NULL, si le paramètre pData a la valeur NULL ou si le paramètre pReserved n’est pas NULL. Cette erreur est également retournée si le paramètre OpCode spécifié n’est pas l’une des valeurs WLAN_AUTOCONF_OPCODE d’un paramètre de configuration qui peut être défini. Cette erreur est également retournée si le paramètre dwDataSize n’est pas défini sur `sizeof(BOOL)`, ou si dwDataSize n’est pas défini `sizeof(BOOL)` sur en fonction de la valeur du paramètre OpCode .
ERROR_INVALID_HANDLE	Le handle hClientHandle est introuvable dans la table handle.
ERROR_NOT_SUPPORTED	Cette fonction a été appelée à partir d’une plateforme non prise en charge. Cette valeur sera retournée si cette fonction a été appelée à partir d’un windows XP avec l’API LAN sans fil ou SP3 pour Windows XP avec le client SP2.
RPC_STATUS	Différents codes d’erreur.

Remarques

La fonction WlanSetAutoConfigParameter définit les paramètres utilisés par le module de configuration automatique (ACM), le composant de configuration sans fil pris en charge sur Windows Vista et versions ultérieures.

En fonction de la valeur du paramètre OpCode , les données pointées par pData seront converties en valeur booléenne avant que le paramètre de configuration automatique ne soit défini. Si pData pointe sur 0, le paramètre est défini sur FALSE ; sinon, le paramètre est défini sur TRUE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [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

Voir aussi

WLAN_AUTOCONF_OPCODE

WlanQueryAutoConfigParameter

Partager via