Funzione WlanRenameProfile (wlanapi.h)

Articolo
08/28/2023

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

Condividi tramite