Fonction WlanUIEditProfile (wlanapi.h)

Article
03/04/2024

Affiche l’interface utilisateur du profil sans fil. Cette interface utilisateur permet d’afficher et de modifier les paramètres avancés d’un profil réseau sans fil.

Syntaxe

DWORD WlanUIEditProfile(
  [in]  DWORD             dwClientVersion,
  [in]  LPCWSTR           wstrProfileName,
  [in]  GUID              *pInterfaceGuid,
  [in]  HWND              hWnd,
  [in]  WL_DISPLAY_PAGES  wlStartPage,
        PVOID             pReserved,
  [out] PWLAN_REASON_CODE pWlanReasonCode
);

Paramètres

[in] dwClientVersion

Spécifie la version la plus élevée de l’API WLAN prise en charge par le client. Les valeurs autres que WLAN_UI_API_VERSION sont ignorées.

[in] wstrProfileName

Contient le nom du profil à afficher ou à modifier. Les noms de profil respectent la casse. Cette chaîne doit être terminée par null.

Le profil fourni doit être présent sur l’interface pInterfaceGuid. Cela signifie que le profil doit avoir été créé et enregistré précédemment dans le magasin de profils et que le profil doit être valide pour l’interface fournie.

[in] pInterfaceGuid

GUID de l’interface.

[in] hWnd

Handle de la fenêtre d’application demandant l’affichage de l’interface utilisateur.

[in] wlStartPage

Valeur WL_DISPLAY_PAGES qui spécifie l’onglet actif lorsque la boîte de dialogue d’interface utilisateur s’affiche.

pReserved

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

[out] pWlanReasonCode

Pointeur vers une valeur WLAN_REASON_CODE qui indique la raison de l’échec de l’affichage de l’interface utilisateur.

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_INVALID_PARAMETER	L’un des paramètres fournis n’est pas valide.
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

Si WlanUIEditProfile retourne ERROR_SUCCESS, toutes les modifications apportées au profil dans l’interface utilisateur sont enregistrées dans le magasin de profils.

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	Wlanui.lib
DLL	Wlanui.dll

Partager via