Fonction WlanRenameProfile (wlanapi.h)

Article
08/28/2023

La fonction WlanRenameProfile renomme le profil spécifié.

Syntaxe

DWORD WlanRenameProfile(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] LPCWSTR    strOldProfileName,
  [in] LPCWSTR    strNewProfileName,
       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] strOldProfileName

Nom du profil à modifier.

[in] strNewProfileName

Nouveau nom du profil.

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
paramètre ERROR_INVALID	hClientHandle a la valeur NULL ou n’est pas valide, pInterfaceGuid a la valeur NULL, strOldProfileName a la valeur NULL, strNewProfileName est NULL ou pReserved n’est pas NULL.
ERROR_INVALID_HANDLE	Le handle hClientHandle est introuvable dans la table handle.
ERROR_NOT_FOUND	Le profil spécifié par strOldProfileName est introuvable dans le magasin de profils.
ERROR_ACCESS_DENIED	L’appelant ne dispose pas des autorisations suffisantes pour renommer le profil.
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.

Spécifications


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

Voir aussi

WlanDeleteProfile

WlanGetProfile

WlanSetProfile

Partager via