Partager via


Fonction WlanSetProfilePosition (wlanapi.h)

La fonction WlanSetProfilePosition définit la position d’un profil unique spécifié dans la liste des préférences.

Syntaxe

DWORD WlanSetProfilePosition(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] LPCWSTR    strProfileName,
  [in] DWORD      dwPosition,
       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] strProfileName

Nom du profil. 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 : Le nom fourni doit correspondre au nom de profil dérivé automatiquement du SSID du réseau. Pour un profil réseau d’infrastructure, le SSID doit être fourni pour le nom du profil. Pour un profil réseau ad hoc, le nom fourni doit être le SSID du réseau ad hoc suivi de -adhoc.

[in] dwPosition

Indique la position dans la liste de préférences vers laquelle le profil doit être déplacé. 0 (zéro) correspond au premier profil de la liste retourné par la fonction WlanGetProfileList .

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 position du profil.

Avant que WlanSetProfilePosition 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 tout utilisateur vers une position inférieure dans la liste des profils, WlanSetProfilePosition 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 l’autorisation d’accès au jeton d’accès du thread appelant, WlanSetProfilePosition retourne ERROR_ACCESS_DENIED.

ERROR_INVALID_PARAMETER
hClientHandle a la valeur NULL ou non valide, pInterfaceGuid a la valeur NULL, strProfileName a la valeur NULL ou pReserved n’est pas NULL.
ERROR_INVALID_HANDLE
Le handle hClientHandle est introuvable dans la table handle.
RPC_STATUS
Différents codes d’erreur.

Remarques

La position des profils de stratégie de groupe ne peut pas être modifiée.

Par défaut, seul un utilisateur connecté en tant que membre du groupe Administrateurs peut modifier la position d’un profil tout utilisateur. Appelez WlanGetSecuritySettings pour déterminer les droits d’utilisateur réels requis pour modifier la position d’un profil tout utilisateur.

Pour définir la position du profil sur la ligne de commande, utilisez la commande netsh wlan set profileorder . Pour plus d’informations, consultez Netsh Commands for Wireless Local Area Network (wlan).

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Les profils ad hoc apparaissent après les profils d’infrastructure dans la liste des profils. Si vous essayez de positionner un profil ad hoc avant un profil d’infrastructure à l’aide de WlanSetProfilePosition, l’appel WlanSetProfilePosition réussit, mais le service Wireless Zero Configuration réorganise la liste des profils afin que le profil ad hoc soit positionné après tous les profils réseau d’infrastructure.

Les profils invités, les profils avec l’authentification WPS (Wireless Provisioning Service) et les profils avec Wi-Fi'authentification Access-None protégée (WPA-None) ne sont pas pris en charge. Tout profil de ce type qui apparaît dans la liste des profils préférés a une position fixe dans la liste des profils. Cela signifie que sa position ne peut pas être modifiée à l’aide de WlanSetProfilePosition et que sa position n’est pas affectée par les changements de position d’autres profils.

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 WlanSetProfilePosition 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

WlanSetProfileList