NtRestoreKey
Sobrescribe el contenido de una clave de registro desde un archivo hive — reemplaza subárboles en bloque.
Prototipo
NTSTATUS NtRestoreKey( HANDLE KeyHandle, HANDLE FileHandle, ULONG Flags );
Argumentos
| Name | Type | Dir | Description |
|---|---|---|---|
| KeyHandle | HANDLE | in | Handle abierto a la clave de registro cuyo contenido será reemplazado (debe tener KEY_WRITE). |
| FileHandle | HANDLE | in | Handle abierto al archivo hive con el contenido fuente (abierto con GENERIC_READ). |
| Flags | ULONG | in | REG_WHOLE_HIVE_VOLATILE (4), REG_REFRESH_HIVE (2), REG_NO_LAZY_FLUSH (4), REG_FORCE_RESTORE (8). |
IDs de syscalls por versión de Windows
| Versión de Windows | ID de syscall | Build |
|---|---|---|
| Win10 1507 | 0x160 | win10-1507 |
| Win10 1607 | 0x167 | win10-1607 |
| Win10 1703 | 0x16D | win10-1703 |
| Win10 1709 | 0x170 | win10-1709 |
| Win10 1803 | 0x172 | win10-1803 |
| Win10 1809 | 0x173 | win10-1809 |
| Win10 1903 | 0x174 | win10-1903 |
| Win10 1909 | 0x174 | win10-1909 |
| Win10 2004 | 0x17A | win10-2004 |
| Win10 20H2 | 0x17A | win10-20h2 |
| Win10 21H1 | 0x17A | win10-21h1 |
| Win10 21H2 | 0x17C | win10-21h2 |
| Win10 22H2 | 0x17C | win10-22h2 |
| Win11 21H2 | 0x184 | win11-21h2 |
| Win11 22H2 | 0x187 | win11-22h2 |
| Win11 23H2 | 0x187 | win11-23h2 |
| Win11 24H2 | 0x189 | win11-24h2 |
| Server 2016 | 0x167 | winserver-2016 |
| Server 2019 | 0x173 | winserver-2019 |
| Server 2022 | 0x182 | winserver-2022 |
| Server 2025 | 0x189 | winserver-2025 |
Módulo del kernel
APIs relacionadas
Stub del syscall
4C 8B D1 mov r10, rcx B8 89 01 00 00 mov eax, 0x189 F6 04 25 08 03 FE 7F 01 test byte ptr [0x7FFE0308], 1 75 03 jne short +3 0F 05 syscall C3 ret CD 2E int 2Eh C3 ret
Notas no documentadas
NtRestoreKey es la inversa de NtSaveKey: reemplaza el contenido de una clave abierta con lo que contiene un archivo hive. Con `REG_FORCE_RESTORE` el kernel lo hace incluso si hay handles abiertos al subárbol destino. El llamante necesita **SeRestorePrivilege**. El wrapper Win32 es `RegRestoreKeyW`. La operación es atómica a nivel de bloque de hive; un fallo parcial deja el destino en estado pre-restauración.
Uso común por malware
Dos patrones dominan. Primero, **manipulación de persistencia**: un atacante con una plantilla Run-key conocida puede sobrescribir `HKLM\Software\Microsoft\Windows\CurrentVersion\Run` (o un subárbol de configuración de servicio) entero, reemplazando todas las entradas en un solo syscall — útil para plantar persistencia *y* borrar entradas competidoras de malware rival. Segundo, **rollback tras manipulación**: herramientas de red team toman un snapshot con NtSaveKey, modifican una clave, ejecutan trabajo y luego revierten con NtRestoreKey para evadir auditoría de cambios en host. Menos común: ransomware lo usa para intercambiar rutas de service-DLL en bloque antes del reboot.
Oportunidades de detección
ETW `Microsoft-Windows-Kernel-Registry` emite un evento load/restore distinto de los value-set. Sysmon Event 13 dispara por valor modificado — un único NtRestoreKey puede producir una *ráfaga* de registros Event 13 con timestamps idénticos bajo la misma clave, un patrón inusual digno de regla. La habilitación de SeRestorePrivilege (Sysmon 4673) inmediatamente antes de una escritura de registro es un indicador anticipado fuerte. Consejo de hunting: alertar sobre el uso del flag REG_FORCE_RESTORE — casi nunca se ve en software benigno.
Ejemplos de syscalls directos
asmx64 direct stub (Win11 24H2)
; Direct syscall stub for NtRestoreKey (SSN 0x189 on Win11 24H2 — drifts per build)
NtRestoreKey PROC
mov r10, rcx ; KeyHandle
mov eax, 189h ; SSN
syscall
ret
NtRestoreKey ENDPcBulk-rewrite Run keys from staged template
// Overwrite HKLM\...\Run wholesale from a prepared hive file — useful for both
// persistence install and rival-eviction. Requires SeRestorePrivilege.
#include <windows.h>
LONG RestoreRunKey(LPCWSTR hivePath) {
HKEY hRun = NULL;
LONG s = RegOpenKeyExW(HKEY_LOCAL_MACHINE,
L"Software\\Microsoft\\Windows\\CurrentVersion\\Run",
0, KEY_ALL_ACCESS, &hRun);
if (s != ERROR_SUCCESS) return s;
// REG_FORCE_RESTORE (8) replaces even with open handles elsewhere.
s = RegRestoreKeyW(hRun, hivePath, 8 /* REG_FORCE_RESTORE */);
RegCloseKey(hRun);
return s;
}cDirect NtRestoreKey call
// Snap a key handle and a hive file handle, then restore atomically.
#include <windows.h>
#include <winternl.h>
typedef NTSTATUS (NTAPI *pNtRestoreKey)(HANDLE, HANDLE, ULONG);
NTSTATUS DoRestore(HANDLE hKey, HANDLE hFile, ULONG flags) {
pNtRestoreKey fn = (pNtRestoreKey)GetProcAddress(
GetModuleHandleA("ntdll.dll"), "NtRestoreKey");
return fn(hKey, hFile, flags);
}Mapeos MITRE ATT&CK
Last verified: 2026-05-20