Fonction WlanRenameProfile (wlanapi.h)
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 |
|---|---|
|
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. |
|
Le handle hClientHandle est introuvable dans la table handle. |
|
Le profil spécifié par strOldProfileName est introuvable dans le magasin de profils. |
|
L’appelant ne dispose pas des autorisations suffisantes pour renommer le profil. |
|
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. |
|
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 |