WlanRenameProfile-Funktion (wlanapi.h)

Artikel
08/28/2023

Die WlanRenameProfile-Funktion benennt das angegebene Profil um.

Syntax

DWORD WlanRenameProfile(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] LPCWSTR    strOldProfileName,
  [in] LPCWSTR    strNewProfileName,
       PVOID      pReserved
);

Parameter

[in] hClientHandle

Das Sitzungshandle des Clients, das durch einen vorherigen Aufruf der WlanOpenHandle-Funktion abgerufen wurde.

[in] pInterfaceGuid

Die GUID der Schnittstelle.

[in] strOldProfileName

Der zu ändernde Profilname.

[in] strNewProfileName

Der neue Name des Profils.

pReserved

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Rückgabecode	Beschreibung
ERROR_INVALID PARAMETER	hClientHandle ist NULL oder ungültig, pInterfaceGuid ist NULL, strOldProfileName ist NULL, strNewProfileName ist NULL, oder pReserved ist nicht NULL.
ERROR_INVALID_HANDLE	Das Handle hClientHandle wurde in der Handle-Tabelle nicht gefunden.
ERROR_NOT_FOUND	Das von strOldProfileName angegebene Profil wurde nicht im Profilspeicher gefunden.
ERROR_ACCESS_DENIED	Der Aufrufer verfügt nicht über ausreichende Berechtigungen, um das Profil umzubenennen.
ERROR_NOT_SUPPORTED	Diese Funktion wurde von einer nicht unterstützten Plattform aufgerufen. Dieser Wert wird zurückgegeben, wenn diese Funktion von einem Windows XP-Client mit SP3 oder einer Wlan-LAN-API für Windows XP mit SP2-Client aufgerufen wurde.
RPC_STATUS	Verschiedene Fehlercodes.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wlanapi.h (einschließlich Wlanapi.h)
Bibliothek	Wlanapi.lib
DLL	Wlanapi.dll

Weitere Informationen

WlanDeleteProfile

WlanGetProfile

WlanSetProfile

Freigeben über