NtQuerySystemEnvironmentValue
Lit une variable d'environnement système BIOS/NV-RAM x86 héritée par nom (interface pré-UEFI).
Prototype
NTSTATUS NtQuerySystemEnvironmentValue( PUNICODE_STRING VariableName, PWCHAR VariableValue, USHORT ValueLength, PUSHORT ReturnLength );
Arguments
| Name | Type | Dir | Description |
|---|---|---|---|
| VariableName | PUNICODE_STRING | in | UNICODE_STRING désignant la variable. Correspond aux noms BIOS NV-RAM hérités ; pas d'espace GUID. |
| VariableValue | PWCHAR | out | Tampon alloué par l'appelant recevant la valeur de la variable en chaîne de caractères larges. |
| ValueLength | USHORT | in | Capacité de VariableValue en octets (taille USHORT : maximum 64 Kio). |
| ReturnLength | PUSHORT | out | Pointeur optionnel recevant le nombre d'octets effectivement écrits. |
IDs de syscalls par version de Windows
| Version de Windows | ID de syscall | Build |
|---|---|---|
| Win10 1507 | 0x145 | win10-1507 |
| Win10 1607 | 0x14C | win10-1607 |
| Win10 1703 | 0x152 | win10-1703 |
| Win10 1709 | 0x155 | win10-1709 |
| Win10 1803 | 0x157 | win10-1803 |
| Win10 1809 | 0x158 | win10-1809 |
| Win10 1903 | 0x159 | win10-1903 |
| Win10 1909 | 0x159 | win10-1909 |
| Win10 2004 | 0x15F | win10-2004 |
| Win10 20H2 | 0x15F | win10-20h2 |
| Win10 21H1 | 0x15F | win10-21h1 |
| Win10 21H2 | 0x160 | win10-21h2 |
| Win10 22H2 | 0x160 | win10-22h2 |
| Win11 21H2 | 0x167 | win11-21h2 |
| Win11 22H2 | 0x16A | win11-22h2 |
| Win11 23H2 | 0x16A | win11-23h2 |
| Win11 24H2 | 0x16C | win11-24h2 |
| Server 2016 | 0x14C | winserver-2016 |
| Server 2019 | 0x158 | winserver-2019 |
| Server 2022 | 0x165 | winserver-2022 |
| Server 2025 | 0x16C | winserver-2025 |
Module noyau
APIs liées
Stub du syscall
4C 8B D1 mov r10, rcx B8 6C 01 00 00 mov eax, 0x16C 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
Interface héritée de l'ère NT/x86 BIOS originale pour lire des valeurs d'environnement système non volatiles. Le nom est résolu via des stockages NV-RAM privés au HAL ; sur les machines UEFI modernes l'appel est essentiellement vestigial — les chemins noyau redirigent les lectures de firmware réelles vers NtQuerySystemEnvironmentValueEx. Nécessite SeSystemEnvironmentPrivilege. La limite de longueur USHORT 16 bits est un artefact historique manifeste et l'une des raisons pour lesquelles le code neuf doit utiliser la variante Ex.
Usage courant par les malwares
Très faible signal offensif en 2025. La plupart du tradecraft moderne ciblant le firmware (LoJax, MosaicRegressor, ESPecter) vise la surface des variables UEFI via les contreparties *Ex*, car c'est là que résident réellement les clés Secure Boot, le BootOrder et l'état de passation au chargeur d'OS. Apparitions occasionnelles dans d'anciens toolkits red-team auditant l'état du BIOS sur machines héritées.
Opportunités de détection
Le fournisseur ETW Microsoft-Windows-Kernel-General émet des événements d'accès firmware ; à corréler avec l'octroi de SeSystemEnvironmentPrivilege sur le token appelant. Les appels depuis des binaires non liés à la gestion firmware (hors bcdedit.exe, mountvol.exe, utilitaires fwupdate, outils de gestion constructeurs) sont intrinsèquement suspects. Les EDR ne hookent presque jamais cet appel directement car le volume légitime est proche de zéro — tout appel devient donc un signal à haute fidélité.
Exemples de syscalls directs
asmx64 direct stub (Win11 24H2)
; Direct syscall stub for NtQuerySystemEnvironmentValue (SSN 0x16C, Win11 24H2)
NtQuerySystemEnvironmentValue PROC
mov r10, rcx
mov eax, 16Ch
syscall
ret
NtQuerySystemEnvironmentValue ENDPcLegacy NV-RAM read via Win32 wrapper
// Win32 calls back into NtQuerySystemEnvironmentValue under the hood.
// Requires SeSystemEnvironmentPrivilege — enable it first or the call returns ERROR_PRIVILEGE_NOT_HELD.
WCHAR buf[256] = {0};
DWORD len = GetFirmwareEnvironmentVariableW(
L"BootOrder",
L"{00000000-0000-0000-0000-000000000000}", // legacy non-UEFI: ignored
buf,
sizeof(buf));
if (len == 0) {
// On modern UEFI systems GetFirmwareEnvironmentVariableW dispatches to the Ex variant.
// Failure here on a UEFI machine is expected for legacy names.
}Mappings MITRE ATT&CK
Last verified: 2026-05-20