Fonction WlanQueryAutoConfigParameter (wlanapi.h)

Article
08/28/2023

La fonction WlanQueryAutoConfigParameter interroge les paramètres du service de configuration automatique.

Syntaxe

DWORD WlanQueryAutoConfigParameter(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_AUTOCONF_OPCODE    OpCode,
                  PVOID                   pReserved,
  [out]           PDWORD                  pdwDataSize,
  [out]           PVOID                   *ppData,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pWlanOpcodeValueType
);

Paramètres

[in] hClientHandle

Handle de session du client, obtenu par un appel précédent à la fonction WlanOpenHandle .

[in] OpCode

Valeur qui spécifie le paramètre de configuration à interroger.

Valeur	Signification
wlan_autoconf_opcode_show_denied_networks	Lorsqu’il est défini, le paramètre ppData contient une valeur BOOL indiquant si les réseaux refusés par l’utilisateur et la stratégie de groupe seront inclus dans la liste des réseaux disponibles. Si la fonction retourne ERROR_SUCCESS et que ppData pointe vers TRUE, les réseaux refusés par l’utilisateur et la stratégie de groupe sont inclus dans la liste des réseaux disponibles ; Si la valeur est FALSE, les réseaux refusés par les stratégies d’utilisateur et de groupe ne sont pas inclus dans la liste des réseaux disponibles.
wlan_autoconf_opcode_power_setting	Lorsqu’il est défini, le paramètre ppData contient une valeur WLAN_POWER_SETTING spécifiant les paramètres d’alimentation.
wlan_autoconf_opcode_only_use_gp_profiles_for_allowed_networks	Lorsqu’il est défini, le paramètre ppData contient une valeur BOOL indiquant si les profils non créés par la stratégie de groupe peuvent être utilisés pour se connecter à un réseau autorisé avec un profil de stratégie de groupe correspondant. Si la fonction retourne ERROR_SUCCESS et que ppData pointe vers TRUE, seuls les profils créés par la stratégie de groupe peuvent être utilisés ; si la valeur est FALSE, n’importe quel profil peut être utilisé.
wlan_autoconf_opcode_allow_explicit_creds	Lorsqu’il est défini, le paramètre ppData contient une valeur BOOL indiquant si l’interface sans fil actuelle a des informations d’identification utilisateur partagées autorisées. Si la fonction retourne ERROR_SUCCESS et que ppData pointe vers TRUE, les informations d’identification utilisateur partagées sont autorisées pour l’interface sans fil actuelle . si la valeur est FALSE, l’interface sans fil actuelle n’autorise pas les informations d’identification utilisateur partagées.
wlan_autoconf_opcode_block_period	Lorsqu’il est défini, le paramètre ppData contient une valeur DWORD qui indique le paramètre de période bloquée pour l’interface sans fil actuelle. La période bloquée est 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 ppData 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. Si la fonction retourne ERROR_SUCCESS et que ppData pointe vers TRUE, l’extensibilité sur une station virtuelle est autorisée ; si la valeur est FALSE, l’extensibilité sur une station virtuelle n’est pas autorisée.

pReserved

Réservé pour un usage futur. Doit être défini sur NULL.

[out] pdwDataSize

Spécifie la taille du paramètre ppData , en octets.

[out] ppData

Pointeur vers la mémoire qui contient la valeur interrogée pour le paramètre spécifié dans OpCode.

Note Si OpCode a la valeur wlan_autoconf_opcode_show_denied_networks, le pointeur référencé par ppData peut pointer vers une valeur entière. Si le pointeur référencé par ppData pointe vers 0, la valeur entière doit être convertie en valeur booléenne FALSE. Si le pointeur référencé par ppData pointe vers un entier différent de zéro, la valeur entière doit être convertie en valeur booléenne TRUE.

[out, optional] pWlanOpcodeValueType

Valeur WLAN_OPCODE_VALUE_TYPE .

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’appelant ne dispose pas des autorisations suffisantes pour obtenir les paramètres de configuration. Lorsqu’il est appelé avec OpCode défini sur wlan_autoconf_opcode_show_denied_networks, WlanQueryAutoConfigParameter récupère la liste de contrôle d’accès discrétionnaire (DACL) stockée avec l’objet wlan_secure_show_denied . Si le DACL ne contient pas d’entrée de contrôle d’accès (ACE) qui accorde WLAN_READ_ACCESS autorisation au jeton d’accès du thread appelant, WlanQueryAutoConfigParameter retourne ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle est NULL ou non valide, pReserved n’est pas NULL, ppData est NULL ou pdwDataSize est NULL.
ERROR_INVALID_HANDLE	Le handle hClientHandle est introuvable dans la table de handles.
ERROR_NOT_SUPPORTED	Cette fonction a été appelée à partir d’une plateforme non prise en charge. Cette valeur est retournée si cette fonction a été appelée à partir d’un windows XP avec SP3 ou de l’API LAN sans fil pour Windows XP avec un client SP2.
RPC_STATUS	Différents codes d’erreur.

Remarques

La fonction WlanQueryAutoConfigParameter interroge 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.

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 (incluez Wlanapi.h)
Bibliothèque	Wlanapi.lib
DLL	Wlanapi.dll

Voir aussi

WLAN_AUTOCONF_OPCODE

WlanSetAutoConfigParameter

Partager via