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 |
|---|---|
|
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. |
|
hClientHandle a la valeur NULL ou non valide, pInterfaceGuid a la valeur NULL, strProfileName a la valeur NULL ou pReserved n’est pas NULL. |
|
Le handle hClientHandle est introuvable dans la table handle. |
|
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 |