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 |