Función RegRenameKey (winreg.h)

Cambia el nombre de la clave del Registro especificada.

Sintaxis

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

Parámetros

hKey

Identificador de la clave cuyo nombre se va a cambiar. El identificador debe abrirse con el derecho de acceso KEY_WRITE. Para obtener más información, consulte Derechos de acceso y seguridad de clave del Registro.

La función RegCreateKeyEx o RegOpenKeyEx devuelve este identificador, o bien puede ser una de las siguientes claves predefinidas:

• HKEY_CLASSES_ROOT
• HKEY_CURRENT_CONFIG
• HKEY_CURRENT_USER
• HKEY_LOCAL_MACHINE
• HKEY_USERS

lpSubKeyName

Nombre de la subclave cuyo nombre se va a cambiar. Esta clave debe ser una subclave de la clave identificada por el parámetro hKey . Este parámetro también puede ser NULL, en cuyo caso se cambiará el nombre de la clave identificada por el parámetro hKey .

lpNewKeyName

Nuevo nombre de la clave. El nuevo nombre no debe existir.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si la función no se ejecuta correctamente, el valor devuelto es un código de error distinto de cero definido en Winerror.h. Puede usar la función FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para obtener una descripción genérica del error. Un código de error de STATUS_ACCESS_DENIED indica que el autor de la llamada no tiene los derechos de acceso necesarios para la clave del Registro o subclaves especificadas.

Comentarios

Esta función se puede usar para cambiar el nombre de un subárbol del Registro completo. El autor de la llamada debe tener KEY_CREATE_SUB_KEY acceso al elemento primario de la clave especificada y al acceso DELETE a todo el subárbol cuyo nombre se va a cambiar.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	winreg.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll

Consulte también

RegCopyTree

Funciones del Registro

Introducción al Registro

SECURITY_ATTRIBUTES