Funzione WlanRenameProfile (wlanapi.h)
La funzione WlanRenameProfile rinomina il profilo specificato.
Sintassi
DWORD WlanRenameProfile(
[in] HANDLE hClientHandle,
[in] const GUID *pInterfaceGuid,
[in] LPCWSTR strOldProfileName,
[in] LPCWSTR strNewProfileName,
PVOID pReserved
);
Parametri
[in] hClientHandle
Handle di sessione del client, ottenuto da una chiamata precedente alla funzione WlanOpenHandle .
[in] pInterfaceGuid
GUID dell'interfaccia.
[in] strOldProfileName
Nome del profilo da modificare.
[in] strNewProfileName
Nuovo nome del profilo.
pReserved
Riservato per utilizzi futuri. Deve essere impostato su NULL.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito può essere uno dei codici restituiti seguenti.
| Codice restituito | Descrizione |
|---|---|
|
hClientHandle è NULL o non valido, pInterfaceGuid è NULL, strOldProfileName è NULL, strNewProfileName è NULL o pReserved non è NULL. |
|
L'handle hClientHandle non è stato trovato nella tabella handle. |
|
Il profilo specificato da strOldProfileName non è stato trovato nell'archivio profili. |
|
Il chiamante non dispone di autorizzazioni sufficienti per rinominare il profilo. |
|
Questa funzione è stata chiamata da una piattaforma non supportata. Questo valore verrà restituito se questa funzione è stata chiamata da un'API Windows XP con SP3 o LAN wireless per Windows XP con il client SP2. |
|
Vari codici di errore. |
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wlanapi.h (include Wlanapi.h) |
| Libreria | Wlanapi.lib |
| DLL | Wlanapi.dll |