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
ERROR_INVALID PARAMETER
hClientHandle è NULL o non valido, pInterfaceGuid è NULL, strOldProfileName è NULL, strNewProfileName è NULL o pReserved non è NULL.
ERROR_INVALID_HANDLE
L'handle hClientHandle non è stato trovato nella tabella handle.
ERROR_NOT_FOUND
Il profilo specificato da strOldProfileName non è stato trovato nell'archivio profili.
ERROR_ACCESS_DENIED
Il chiamante non dispone di autorizzazioni sufficienti per rinominare il profilo.
ERROR_NOT_SUPPORTED
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.
RPC_STATUS
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

Vedi anche

WlanDeleteProfile

WlanGetProfile

WlanSetProfile