NtQueryEaFile
Lit les attributs étendus NTFS (EA) depuis un handle de fichier, avec filtre/pagination optionnels.
Prototype
NTSTATUS NtQueryEaFile( HANDLE FileHandle, PIO_STATUS_BLOCK IoStatusBlock, PVOID Buffer, ULONG Length, BOOLEAN ReturnSingleEntry, PVOID EaList, ULONG EaListLength, PULONG EaIndex, BOOLEAN RestartScan );
Arguments
| Name | Type | Dir | Description |
|---|---|---|---|
| FileHandle | HANDLE | in | Handle vers un fichier ouvert (doit inclure l'accès FILE_READ_EA). |
| IoStatusBlock | PIO_STATUS_BLOCK | out | Reçoit le statut de complétion et les octets écrits dans Buffer. |
| Buffer | PVOID | out | Reçoit un tableau d'enregistrements FILE_FULL_EA_INFORMATION. |
| Length | ULONG | in | Taille de Buffer en octets. |
| ReturnSingleEntry | BOOLEAN | in | Si TRUE, retourne uniquement le premier EA correspondant, même si d'autres tiennent dans Buffer. |
| EaList | PVOID | in | Liste optionnelle de FILE_GET_EA_INFORMATION nommant les EA à récupérer (NULL = tous). |
| EaListLength | ULONG | in | Taille d'EaList en octets, ou 0 si EaList est NULL. |
| EaIndex | PULONG | in | Index optionnel (base 1) dans la liste des EA du fichier pour démarrer l'énumération. |
| RestartScan | BOOLEAN | in | Si TRUE, redémarre l'énumération depuis le premier EA ; FALSE continue depuis l'appel précédent. |
IDs de syscalls par version de Windows
| Version de Windows | ID de syscall | Build |
|---|---|---|
| Win10 1507 | 0x12D | win10-1507 |
| Win10 1607 | 0x133 | win10-1607 |
| Win10 1703 | 0x138 | win10-1703 |
| Win10 1709 | 0x13B | win10-1709 |
| Win10 1803 | 0x13D | win10-1803 |
| Win10 1809 | 0x13E | win10-1809 |
| Win10 1903 | 0x13F | win10-1903 |
| Win10 1909 | 0x13F | win10-1909 |
| Win10 2004 | 0x145 | win10-2004 |
| Win10 20H2 | 0x145 | win10-20h2 |
| Win10 21H1 | 0x145 | win10-21h1 |
| Win10 21H2 | 0x146 | win10-21h2 |
| Win10 22H2 | 0x146 | win10-22h2 |
| Win11 21H2 | 0x14C | win11-21h2 |
| Win11 22H2 | 0x14E | win11-22h2 |
| Win11 23H2 | 0x14E | win11-23h2 |
| Win11 24H2 | 0x150 | win11-24h2 |
| Server 2016 | 0x133 | winserver-2016 |
| Server 2019 | 0x13E | winserver-2019 |
| Server 2022 | 0x14B | winserver-2022 |
| Server 2025 | 0x150 | winserver-2025 |
Module noyau
APIs liées
Stub du syscall
4C 8B D1 mov r10, rcx B8 50 01 00 00 mov eax, 0x150 ; Win11 24H2 SSN 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
Contrepartie de `NtSetEaFile`. Avec 9 arguments, dont deux passés sur la pile en x64, c'est l'un des syscalls fichier les plus lourds — les appelants l'enveloppent généralement dans un petit helper qui passe `NULL/0/NULL/FALSE` pour le trio filtre/index/restart optionnel quand on veut "tout récupérer". Le noyau retourne `STATUS_NO_EAS_ON_FILE` pour les fichiers sans flux EA et `STATUS_NONEXISTENT_EA_ENTRY` pour une recherche nommée manquante — deux oracles négatifs utiles pour sonder.
Usage courant par les malwares
Côté lecture du pattern de furtivité EA : un implant ayant précédemment caché configuration ou shellcode via `NtSetEaFile` le recharge ensuite avec `NtQueryEaFile`. Nommer l'EA explicitement via le paramètre `EaList` est préférable à une énumération complète car cela laisse une empreinte télémétrique plus faible et évite de déclencher les scanners qui parcourent chaque EA. Certains loaders utilisent aussi le chemin EA comme canal latéral d'intégrité — la présence du payload et sa taille exacte servent de détecteur d'altération avant déchiffrement.
Opportunités de détection
`NtQueryEaFile` en soi est bénin — l'OS lui-même l'appelle sur les partages de profils itinérants et chaque fois que les EA de permissions WSL/Cygwin sont lus. Le signal est dans le *pattern* : un processus qui ouvre un fichier non-WSL avec FILE_READ_EA et qui déchiffre/saute immédiatement dans le blob retourné. L'événement ETW Microsoft-Windows-Kernel-File `FileQueryEa`, couplé à un VirtualProtect→RX subséquent sur une région récemment écrite depuis ce buffer, est la corrélation à haute fidélité. Les requêtes EA isolées depuis `svchost.exe`, `lsass.exe` ou tout binaire Microsoft signé contre un fichier accessible en écriture par l'utilisateur méritent d'être remontées.
Exemples de syscalls directs
cTargeted single-EA read
// Fetch only the 'CONFIG.BIN' EA — avoids a noisy full enumeration.
HANDLE h = CreateFileW(L"C:\\ProgramData\\update.dat", FILE_READ_EA, FILE_SHARE_READ,
NULL, OPEN_EXISTING, 0, NULL);
struct {
ULONG NextEntryOffset;
UCHAR EaNameLength;
CHAR EaName[12]; // "CONFIG.BIN\0" + padding
} eaList = { 0, 10, "CONFIG.BIN\0" };
BYTE out[4096];
IO_STATUS_BLOCK iosb;
NTSTATUS st = NtQueryEaFile(h, &iosb, out, sizeof(out),
TRUE, // single entry
&eaList, sizeof(eaList),
NULL, // no index
TRUE); // restart scan
if (NT_SUCCESS(st)) {
PFILE_FULL_EA_INFORMATION ea = (PFILE_FULL_EA_INFORMATION)out;
decrypt_and_run(ea->EaName + ea->EaNameLength + 1, ea->EaValueLength);
}asmx64 direct stub
; NtQueryEaFile direct syscall (Win11 24H2 SSN 0x150)
NtQueryEaFile PROC
mov r10, rcx
mov eax, 150h
syscall
ret
NtQueryEaFile ENDPrustEnumerate every EA on a file
// Cargo: windows-sys = "0.59"
use windows_sys::Win32::Foundation::HANDLE;
use windows_sys::Win32::System::LibraryLoader::*;
type NtQueryEaFileFn = unsafe extern "system" fn(
HANDLE, *mut u8, *mut u8, u32, u8, *const u8, u32, *mut u32, u8,
) -> i32;
unsafe fn dump_eas(h: HANDLE) -> Vec<(String, Vec<u8>)> {
let nt = GetModuleHandleA(b"ntdll.dll\0".as_ptr());
let f: NtQueryEaFileFn = std::mem::transmute(
GetProcAddress(nt, b"NtQueryEaFile\0".as_ptr()).unwrap()
);
let mut buf = vec![0u8; 0x10000];
let mut iosb = [0u8; 16];
let st = f(h, iosb.as_mut_ptr(), buf.as_mut_ptr(), buf.len() as u32,
0, std::ptr::null(), 0, std::ptr::null_mut(), 1);
if st < 0 { return vec![]; }
// Walk NextEntryOffset chain ... (omitted for brevity)
Vec::new()
}Mappings MITRE ATT&CK
Last verified: 2026-05-20