RegRenameKey-Funktion (winreg.h)

Ändert den Namen des angegebenen Registrierungsschlüssels.

Syntax

LSTATUS RegRenameKey(
  HKEY    hKey,
  LPCWSTR lpSubKeyName,
  LPCWSTR lpNewKeyName
);

Parameter

hKey

Ein Handle für den schlüssel, der umbenannt werden soll. Das Handle muss mit dem Zugriffsrecht KEY_WRITE geöffnet werden. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.

Dieses Handle wird von der RegCreateKeyEx - oder RegOpenKeyEx-Funktion zurückgegeben, oder es kann sich um einen der folgenden vordefinierten Schlüssel handelt:

• HKEY_CLASSES_ROOT
• HKEY_CURRENT_CONFIG
• HKEY_CURRENT_USER
• HKEY_LOCAL_MACHINE
• HKEY_USERS

lpSubKeyName

Der Name des umzubenennten Unterschlüssels. Dieser Schlüssel muss ein Unterschlüssel des Schlüssels sein, der durch den hKey-Parameter identifiziert wird. Dieser Parameter kann auch NULL sein. In diesem Fall wird der durch den hKey-Parameter identifizierte Schlüssel umbenannt.

lpNewKeyName

Der neue Name des Schlüssels. Der neue Name darf noch nicht vorhanden sein.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein in Winerror.h definierter Fehlercode ungleich null. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen. Ein Fehlercode von STATUS_ACCESS_DENIED gibt an, dass der Aufrufer nicht über die erforderlichen Zugriffsrechte für den angegebenen Registrierungsschlüssel oder die angegebenen Unterschlüssel verfügt.

Hinweise

Diese Funktion kann verwendet werden, um eine gesamte Registrierungsunterstruktur umzubenennen. Der Aufrufer muss KEY_CREATE_SUB_KEY Zugriff auf das übergeordnete Element des angegebenen Schlüssels und DELETE-Zugriff auf die gesamte umbenennte Teilstruktur haben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	winreg.h (Windows.h einschließen)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

RegCopyTree

Registrierungsfunktionen

Übersicht über die Registrierung

SECURITY_ATTRIBUTES