WlanRenameProfile-Funktion (wlanapi.h)
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 |
|---|---|
|
hClientHandle ist NULL oder ungültig, pInterfaceGuid ist NULL, strOldProfileName ist NULL, strNewProfileName ist NULL, oder pReserved ist nicht NULL. |
|
Das Handle hClientHandle wurde in der Handle-Tabelle nicht gefunden. |
|
Das von strOldProfileName angegebene Profil wurde nicht im Profilspeicher gefunden. |
|
Der Aufrufer verfügt nicht über ausreichende Berechtigungen, um das Profil umzubenennen. |
|
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. |
|
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 |