Función NtRenameKey (winternl.h)
[Esta función se puede cambiar o quitar de Windows sin previo aviso. ]
Cambia el nombre de la clave del Registro especificada.
Sintaxis
__kernel_entry NTSTATUS NtRenameKey(
[in] HANDLE KeyHandle,
[in] PUNICODE_STRING NewName
);
Parámetros
[in] KeyHandle
Identificador de la clave cuyo nombre se va a cambiar. El identificador debe abrirse con el derecho de acceso KEY_WRITE.
[in] NewName
Puntero a una cadena UNICODE que es el nuevo nombre de la clave.
Valor devuelto
Devuelve un código de error o NTSTATUS . 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.
Los formularios y la importancia de los códigos de error NTSTATUS se enumeran en el archivo de encabezado Ntstatus.h disponible en el WDK y se describen en la documentación de WDK.
Comentarios
Esta función no tiene ningún archivo de encabezado asociado. También puede usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Ntdll.dll.
La función NtRenameKey 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
| Plataforma de destino | Windows |
| Encabezado | winternl.h |
| Library | ntdll.lib |
| Archivo DLL | ntdll.dll |