NtSetVolumeInformationFile
Modifica propiedades de volumen escribibles — principalmente la etiqueta — del volumen asociado a un handle de archivo.
Prototipo
NTSTATUS NtSetVolumeInformationFile( HANDLE FileHandle, PIO_STATUS_BLOCK IoStatusBlock, PVOID FsInformation, ULONG Length, FS_INFORMATION_CLASS FsInformationClass );
Argumentos
| Name | Type | Dir | Description |
|---|---|---|---|
| FileHandle | HANDLE | in | Handle a la raíz del volumen o un archivo en él; abierto con FILE_WRITE_ATTRIBUTES. |
| IoStatusBlock | PIO_STATUS_BLOCK | out | Recibe el estado de finalización de la operación set. |
| FsInformation | PVOID | in | Buffer de entrada suministrado por el llamador con la estructura correspondiente a FsInformationClass (p. ej. FILE_FS_LABEL_INFORMATION). |
| Length | ULONG | in | Tamaño en bytes del buffer FsInformation. |
| FsInformationClass | FS_INFORMATION_CLASS | in | Clase a establecer; en la práctica casi siempre FileFsLabelInformation (2) o FileFsControlInformation (6). |
IDs de syscalls por versión de Windows
| Versión de Windows | ID de syscall | Build |
|---|---|---|
| Win10 1507 | 0x196 | win10-1507 |
| Win10 1607 | 0x19F | win10-1607 |
| Win10 1703 | 0x1A5 | win10-1703 |
| Win10 1709 | 0x1A8 | win10-1709 |
| Win10 1803 | 0x1AA | win10-1803 |
| Win10 1809 | 0x1AB | win10-1809 |
| Win10 1903 | 0x1AC | win10-1903 |
| Win10 1909 | 0x1AC | win10-1909 |
| Win10 2004 | 0x1B2 | win10-2004 |
| Win10 20H2 | 0x1B2 | win10-20h2 |
| Win10 21H1 | 0x1B2 | win10-21h1 |
| Win10 21H2 | 0x1B4 | win10-21h2 |
| Win10 22H2 | 0x1B4 | win10-22h2 |
| Win11 21H2 | 0x1BD | win11-21h2 |
| Win11 22H2 | 0x1C1 | win11-22h2 |
| Win11 23H2 | 0x1C1 | win11-23h2 |
| Win11 24H2 | 0x1C4 | win11-24h2 |
| Server 2016 | 0x19F | winserver-2016 |
| Server 2019 | 0x1AB | winserver-2019 |
| Server 2022 | 0x1BA | winserver-2022 |
| Server 2025 | 0x1C4 | winserver-2025 |
Módulo del kernel
APIs relacionadas
Stub del syscall
4C 8B D1 mov r10, rcx B8 C4 01 00 00 mov eax, 0x1C4 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
Mucho más rara que su hermana `Query` porque los valores FS_INFORMATION_CLASS que los filesystems realmente aceptan en la ruta `Set` son limitados: `FileFsLabelInformation` (renombrar el volumen), `FileFsControlInformation` (política de cuota en NTFS), y `FileFsObjectIdInformation` (asignación de object-id NTFS). La mayoría de las demás clases devuelven `STATUS_INVALID_INFO_CLASS`. El IRP pasa por `IRP_MJ_SET_VOLUME_INFORMATION` y llega a NTFS en `NtfsFsdSetVolumeInformation`. Renombrar un volumen requiere el privilegio `SE_MANAGE_VOLUME_NAME`, que tienen administradores interactivos y `LocalSystem` — no usuarios estándar — así que el uso de este syscall desde un contexto no-admin es en sí mismo telemetría inusual.
Uso común por malware
Nicho pero visible. Un puñado de familias ransomware — notoriamente **Petya/NotPetya** (2017, cifrador MBR) y algunos afiliados **Babuk** / **DarkSide** — emiten `FileFsLabelInformation` para sobrescribir el nombre del volumen con su marca o una cadena `READ_ME_*`, para que cualquier pantalla de recuperación pre-boot o `dir C:\` muestre el marcador de rescate antes de que el usuario abra la nota. **BlackMatter** (2021) renombraba etiquetas a un hash corto correspondiente a su ransom ID. Más allá del ransomware, la llamada está esencialmente sin uso por malware commodity — no hay primitiva ofensiva aquí, solo branding.
Oportunidades de detección
Microsoft Defender for Endpoint expone cambios de etiqueta vía `DeviceEvents` ActionType `VolumeMounted` / `VolumeRenamed`. Sysmon *no* cubre esto directamente pero las trazas IRP ETW `Microsoft-Windows-Kernel-File` muestran `IRP_MJ_SET_VOLUME_INFORMATION` con clase 2 (`FileFsLabelInformation`). Como la ruta privilegiada es tan estrecha, *cualquier* `NtSetVolumeInformationFile(FileFsLabelInformation)` desde un proceso no confiable — algo que no sea `explorer.exe`, `cmd.exe label`, `format.com` o un producto de backup conocido — debe considerarse indicación ransomware de alta confianza, sobre todo encadenado con enumeración `NtQueryVolumeInformationFile` de todas las letras de unidad segundos antes.
Ejemplos de syscalls directos
asmx64 direct stub (Win11 24H2)
; Direct syscall stub for NtSetVolumeInformationFile (SSN 0x1C4 on Win11 24H2 / Server 2025)
NtSetVolumeInformationFile PROC
mov r10, rcx ; syscall convention
mov eax, 1C4h ; SSN — drifts; resolve dynamically for portability
syscall
ret
NtSetVolumeInformationFile ENDPcPetya-style volume relabel
// Requires SE_MANAGE_VOLUME_NAME privilege. Petya/NotPetya stamped
// volume labels with their ransom marker — visible in pre-boot UI.
#include <ntstatus.h>
typedef struct _FILE_FS_LABEL_INFORMATION {
ULONG VolumeLabelLength; // bytes, not chars
WCHAR VolumeLabel[1];
} FILE_FS_LABEL_INFORMATION;
WCHAR label[] = L"READ_ME_NOW";
SIZE_T bytes = sizeof(label) - sizeof(WCHAR);
BYTE buf[sizeof(FILE_FS_LABEL_INFORMATION) + sizeof(label)];
FILE_FS_LABEL_INFORMATION* p = (FILE_FS_LABEL_INFORMATION*)buf;
p->VolumeLabelLength = (ULONG)bytes;
memcpy(p->VolumeLabel, label, bytes);
IO_STATUS_BLOCK iosb;
NTSTATUS st = NtSetVolumeInformationFile(
hVolumeRoot, &iosb, p,
(ULONG)(sizeof(FILE_FS_LABEL_INFORMATION) + bytes),
2 /* FileFsLabelInformation */);rustSetVolumeLabelW wrapper (windows-sys)
// Cargo: windows-sys = "0.59" (Win32_Storage_FileSystem)
use windows_sys::Win32::Storage::FileSystem::SetVolumeLabelW;
use std::ffi::OsStr;
use std::os::windows::ffi::OsStrExt;
// Internally calls NtSetVolumeInformationFile(FileFsLabelInformation).
fn relabel(root: &str, label: &str) -> bool {
let to_wide = |s: &str| -> Vec<u16> { OsStr::new(s).encode_wide().chain(Some(0)).collect() };
let r = to_wide(root);
let l = to_wide(label);
unsafe { SetVolumeLabelW(r.as_ptr(), l.as_ptr()) != 0 }
}Mapeos MITRE ATT&CK
Last verified: 2026-05-20