Fonction WlanSetProfileList (wlanapi.h)

  • Article

La fonction WlanSetProfileList définit l’ordre de préférence des profils pour une interface donnée.

Syntaxe

DWORD WlanSetProfileList(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] DWORD      dwItems,
  [in] LPCWSTR    *strProfileNames,
       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.

[in] dwItems

Nombre de profils dans le paramètre strProfileNames .

[in] strProfileNames

Noms des profils dans l’ordre souhaité. Les noms de profil respectent la casse. Cette chaîne doit être terminée par null.

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Les noms fournis doivent correspondre aux noms de profil dérivés automatiquement du SSID du réseau. Pour les profils réseau d’infrastructure, le SSID doit être fourni pour le nom du profil. Pour les profils réseau ad hoc, le nom fourni doit être le SSID du réseau ad hoc suivi de -adhoc.

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’appelant ne dispose pas des autorisations suffisantes pour modifier la liste des profils.

Avant que WlanSetProfileList n’effectue une opération qui modifie l’ordre relatif des profils tous les utilisateurs dans la liste des profils ou déplace un profil utilisateur à une position inférieure dans la liste des profils, WlanSetProfileList récupère la liste de contrôle d’accès discrétionnaire (DACL) stockée avec l’objet wlan_secure_all_user_profiles_order . 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 autorisation au jeton d’accès du thread appelant, WlanSetProfileList retourne ERROR_ACCESS_DENIED.
ERROR_INVALID_HANDLE
 Le handle hClientHandle est introuvable dans la table handle.
ERROR_INVALID_PARAMETER
 L’une des conditions suivantes s’est produite :
  • hClientHandle a la valeur NULL ou non valide.
  • pInterfaceGuid a la valeur NULL.
  • dwItems est 0.
  • strProfileNames a lavaleur NULL.
  • Le même nom de profil apparaît plusieurs fois dans strProfileNames.
  • pReserved n’a pas la valeur NULL.
ERROR_NOT_FOUND
 strProfileNames contient le nom d’un profil qui n’est pas présent dans le magasin de profils.
RPC_STATUS
 Différents codes d’erreur.

Remarques

La fonction WlanSetProfileList définit l’ordre de préférence des profils LAN sans fil pour une interface sans fil donnée.

Les profils de la liste doivent correspondre à un avec les profils actuels retournés par la fonction WlanGetProfileList . La position des profils de stratégie de groupe ne peut pas être modifiée.

Toutes les fonctions LAN sans fil nécessitent un GUID d’interface pour l’interface sans fil lors de l’exécution d’opérations de profil. Lorsqu’une interface sans fil est supprimée, son état est effacé du service LAN sans fil (WLANSVC) et aucune opération de profil n’est possible.

La fonction WlanSetProfileList peut échouer avec ERROR_INVALID_PARAMETER si l’interface sans fil spécifiée dans le paramètre pInterfaceGuid a été supprimée du système (un adaptateur sans fil USB qui a été supprimé, par exemple).

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

WlanGetProfile

WlanGetProfileList

WlanSetProfile