NtEnumerateBootEntries
Retourne un tableau compact de structures BOOT_ENTRY décrivant chaque option de démarrage firmware enregistrée.
Prototype
NTSTATUS NtEnumerateBootEntries( PVOID Buffer, PULONG BufferLength );
Arguments
| Name | Type | Dir | Description |
|---|---|---|---|
| Buffer | PVOID | out | Buffer alloué par l'appelant qui reçoit une séquence compactée d'enregistrements BOOT_ENTRY_LIST (chacun contenant un NextEntryOffset et une BOOT_ENTRY inline). Peut être NULL pour interroger la taille requise. |
| BufferLength | PULONG | in/out | En entrée : taille de Buffer en octets. En sortie : octets écrits, ou taille requise lorsque STATUS_BUFFER_TOO_SMALL est retourné. |
IDs de syscalls par version de Windows
| Version de Windows | ID de syscall | Build |
|---|---|---|
| Win10 1507 | 0xCF | win10-1507 |
| Win10 1607 | 0xD2 | win10-1607 |
| Win10 1703 | 0xD5 | win10-1703 |
| Win10 1709 | 0xD6 | win10-1709 |
| Win10 1803 | 0xD7 | win10-1803 |
| Win10 1809 | 0xD8 | win10-1809 |
| Win10 1903 | 0xD9 | win10-1903 |
| Win10 1909 | 0xD9 | win10-1909 |
| Win10 2004 | 0xDE | win10-2004 |
| Win10 20H2 | 0xDE | win10-20h2 |
| Win10 21H1 | 0xDE | win10-21h1 |
| Win10 21H2 | 0xDF | win10-21h2 |
| Win10 22H2 | 0xDF | win10-22h2 |
| Win11 21H2 | 0xE4 | win11-21h2 |
| Win11 22H2 | 0xE5 | win11-22h2 |
| Win11 23H2 | 0xE5 | win11-23h2 |
| Win11 24H2 | 0xE7 | win11-24h2 |
| Server 2016 | 0xD2 | winserver-2016 |
| Server 2019 | 0xD8 | winserver-2019 |
| Server 2022 | 0xE3 | winserver-2022 |
| Server 2025 | 0xE7 | winserver-2025 |
Module noyau
APIs liées
Stub du syscall
4C 8B D1 mov r10, rcx B8 E7 00 00 00 mov eax, 0xE7 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
Notes non documentées
Schéma classique en deux appels : invoquer avec `Buffer = NULL` pour récupérer la taille requise, allouer, puis rappeler. La sortie est une liste chaînée — chaque `BOOT_ENTRY_LIST.NextEntryOffset` est un delta en octets depuis le début de l'enregistrement courant vers le suivant (zéro termine). En coulisses, le noyau parcourt la liste côté firmware : `BootOrder` NVRAM + variables `Boot####` sur UEFI, énumération de la ruche BCD sur BIOS legacy. SeSystemEnvironmentPrivilege est requis même en *lecture*.
Usage courant par les malwares
L'énumération est l'étape de reconnaissance de toute kill chain de persistance BCD : le malware a besoin de l'ID `{bootmgr}` existant avant de pouvoir appeler NtModifyBootEntry, et il lui faut l'ordre courant avant NtSetBootEntryOrder. Le module UEFI de TrickBoot commence notoirement par une passe d'inventaire appelant l'équivalent de `BcdEnumerateObjects` + `NtEnumerateBootEntries` pour empreindre le firmware (fournisseur, versions vulnérables de bootmgr, présence d'entrées recovery) et la rapporter au C2 avant de décider de déployer ou non l'étage bootkit.
Opportunités de détection
L'énumération en lecture seule est rarement intéressante isolée — des outils légitimes (`bcdedit`, Windows Update, configuration BitLocker) l'appellent en routine. La suspicion vient du **contexte** : un processus non-installeur, non en contexte système, qui ouvre un handle réclamant SeSystemEnvironmentPrivilege *et* énumère immédiatement les entrées BCD, est anormal. Détection : interroger les événements d'audit 4673 pour l'usage de SeSystemEnvironmentPrivilege, puis corréler avec le chemin image du processus. Les EDR qui télémétrent les transitions NtSetInformationToken / NtAdjustPrivilegesToken vers SE_PRIVILEGE_ENABLED pour SeSystemEnvironment peuvent attraper l'étape d'acquisition de privilège qui précède tout appel d'écriture.
Exemples de syscalls directs
asmx64 direct stub (Win11 24H2, SSN 0xE7)
NtEnumerateBootEntries PROC
mov r10, rcx ; PVOID Buffer
mov eax, 0E7h ; Win11 24H2
syscall
ret
NtEnumerateBootEntries ENDPcTwo-call size query + walk
// Enumerate every firmware boot entry, print FriendlyName.
extern NTSTATUS NTAPI NtEnumerateBootEntries(PVOID, PULONG);
void dump_entries(void) {
ULONG size = 0;
NtEnumerateBootEntries(NULL, &size); // STATUS_BUFFER_TOO_SMALL
if (size == 0) return;
PBYTE buf = (PBYTE)HeapAlloc(GetProcessHeap(), 0, size);
if (NT_SUCCESS(NtEnumerateBootEntries(buf, &size))) {
PBYTE p = buf;
while (p < buf + size) {
PBOOT_ENTRY_LIST list = (PBOOT_ENTRY_LIST)p;
PBOOT_ENTRY be = &list->BootEntry;
wprintf(L"id=%08X name=%s\n", be->Id,
(LPCWSTR)((PBYTE)be + be->FriendlyNameOffset));
if (!list->NextEntryOffset) break;
p += list->NextEntryOffset;
}
}
HeapFree(GetProcessHeap(), 0, buf);
}Mappings MITRE ATT&CK
Last verified: 2026-05-20