Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |