> Windows Syscalls
ntoskrnl.exeT1112T1547.001T1106

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

NameTypeDirDescription
KeyHandleHANDLEinHandle abierto a la clave de registro cuyo contenido será reemplazado (debe tener KEY_WRITE).
FileHandleHANDLEinHandle abierto al archivo hive con el contenido fuente (abierto con GENERIC_READ).
FlagsULONGinREG_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 WindowsID de syscallBuild
Win10 15070x160win10-1507
Win10 16070x167win10-1607
Win10 17030x16Dwin10-1703
Win10 17090x170win10-1709
Win10 18030x172win10-1803
Win10 18090x173win10-1809
Win10 19030x174win10-1903
Win10 19090x174win10-1909
Win10 20040x17Awin10-2004
Win10 20H20x17Awin10-20h2
Win10 21H10x17Awin10-21h1
Win10 21H20x17Cwin10-21h2
Win10 22H20x17Cwin10-22h2
Win11 21H20x184win11-21h2
Win11 22H20x187win11-22h2
Win11 23H20x187win11-23h2
Win11 24H20x189win11-24h2
Server 20160x167winserver-2016
Server 20190x173winserver-2019
Server 20220x182winserver-2022
Server 20250x189winserver-2025

Módulo del kernel

ntoskrnl.exeNtRestoreKey

APIs relacionadas

RegRestoreKeyWRegReplaceKeyWNtSaveKeyNtLoadKeyNtUnloadKey

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 ENDP

cBulk-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