estructura FILE_FS_PERSISTENT_VOLUME_INFORMATION (ntifs.h)
La estructura FILE_FS_PERSISTENT_VOLUME_INFORMATION se usa para controlar la configuración persistente de un volumen del sistema de archivos. La configuración persistente persiste en un volumen del sistema de archivos entre reinicios del equipo.
Sintaxis
typedef struct _FILE_FS_PERSISTENT_VOLUME_INFORMATION {
ULONG VolumeFlags;
ULONG FlagMask;
ULONG Version;
ULONG Reserved;
} FILE_FS_PERSISTENT_VOLUME_INFORMATION, *PFILE_FS_PERSISTENT_VOLUME_INFORMATION;
Miembros
VolumeFlags
Configuración de estado persistente para un volumen del sistema de archivos. Este valor es una combinación OR bit a bit de lo siguiente.
| Valor | Significado |
|---|---|
| PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED 0x00000001 | Un 0 para este bit indica que la creación de nombres cortos 8.3 está habilitada y un 1 indica que la creación de nombres cortos está deshabilitada. 8.3 los nombres de archivo cortos tienen como máximo ocho caracteres, seguidos de un punto "." y una extensión de nombre de archivo de como máximo tres caracteres. |
| PERSISTENT_VOLUME_STATE_VOLUME_SCRUB_DISABLED 0x00000002 | Cuando se establece, esta marca indica que la limpieza de volúmenes está deshabilitada para el volumen. Válido a partir de Windows 8. |
| PERSISTENT_VOLUME_STATE_GLOBAL_METADATA_NO_SEEK_PENALTY 0x00000004 | La penalización global sin búsqueda está habilitada para un volumen en capas. Válido a partir de Windows 8.1. |
| PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY 0x00000008 | La penalización local sin búsqueda está habilitada para un volumen en capas. Válido a partir de Windows 8.1. |
| PERSISTENT_VOLUME_STATE_NO_HEAT_GATHERING 0x00000010 | Cuando se establece, la recopilación de calor no está habilitada para el volumen en capas. Válido a partir de Windows 8.1. |
| PERSISTENT_VOLUME_STATE_CONTAINS_BACKING_WIM 0x00000020 | Indica que este volumen respalda el volumen del sistema con archivos de un archivo de formato de imagen de Windows (WIM). Válido a partir de Windows 8.1 Update. |
| PERSISTENT_VOLUME_STATE_BACKED_BY_WIM 0x00000040 | Indica que este volumen depende de otro volumen para proporcionar archivos de arranque críticos del sistema. El otro volumen contiene un archivo WIM que respalda los archivos de este volumen. Esta marca es de solo lectura. Válido a partir de Windows 8.1 Update. |
| PERSISTENT_VOLUME_STATE_DEV_VOLUME 0x00002000 | Indica que este volumen tiene el formato de volumen de desarrollador. El sistema de archivos y otros componentes del sistema pueden usar esto para habilitar las optimizaciones que no requieren que un administrador confíe en el volumen en un equipo determinado. Válido a partir de Windows 11, versión 22H2 de actualización de septiembre. |
| PERSISTENT_VOLUME_STATE_TRUSTED_VOLUME 0x00004000 | Indica que un administrador de una máquina determinada tiene confianza en este volumen y está dispuesto a habilitar optimizaciones como no tener filtros antivirus asociados al volumen. Esta información se conserva en el registro en una máquina determinada. El sistema de archivos y otros componentes del sistema pueden usar esto para habilitar las optimizaciones que requieren que un administrador confíe en el volumen de un equipo determinado. Válido a partir de Windows 11, versión 22H2 de actualización de septiembre. |
FlagMask
Valor de máscara para las marcas válidas que pueden aparecer en VolumeFlags. Se trata de una combinación OR bit a bit de las marcas deseadas descritas para VolumeFlags.
Version
Número de versión de esta estructura. establézcalo en 1.
Reserved
Reservado. Establézcalo en 0;
Comentarios
La estructura FILE_FS_PERSISTENT_VOLUME_INFORMATION se usa con los códigos de control FSCTL_SET_PERSISTENT_VOLUME_STATE y FSCTL_QUERY_PERSISTENT_VOLUME_STATE .
Para consultar las marcas de estado, FlagMask se establece en una combinación de marcas que se van a comprobar. Por ejemplo, si las únicas marcas de penalización de búsqueda son de interés, FlagMask = PERSISTENT_VOLUME_STATE_GLOBAL_METADATA_NO_SEEK_PENALTY | PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY. Además, si solo se consulta la compatibilidad con nombres cortos, establezca FlagMask = PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED.
Al establecer o borrar las marcas de estado de volumen persistentes, con FSCTL_SET_PERSISTENT_VOLUME_STATE, FlagMask se establece en todas las marcas de VolumeFlags que se verán afectadas para el volumen. VolumeFlags contiene las marcas de estado persistentes reales que se van a establecer para el volumen. En el ejemplo siguiente se muestra cómo establecer los miembros de FILE_FS_PERSISTENT_VOLUME_INFORMATION para habilitar la creación de nombres cortos para un volumen.
IO_STATUS_BLOCK IoStatus;
FILE_FS_PERSISTENT_VOLUME_INFORMATION PersistVolInfo;
NTSTATUS status;
PersistVolInfo.VolumeFlags = 0; // enable shortname creation on this volume
PersistVolInfo.FlagMask = PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED;
PersistVolInfo.Version = 1;
PersistVolInfo.Reserved = 0;
// issue the request to the file system to set the enable state
//
status = ZwFsControlFile( VolumeHandle,
NULL,
NULL,
NULL,
&IoStatus,
FSCTL_SET_PERSISTENT_VOLUME_STATE,
&PersistVolInfo,
sizeof(FILE_FS_PERSISTENT_VOLUME_INFORMATION),
NULL,
0 );
El miembro Version debe establecerse en la versión actual de 1 para una consulta y una solicitud set.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 |
| Encabezado | ntifs.h (incluya Ntifs.h) |