structure FILE_FS_PERSISTENT_VOLUME_INFORMATION (ntifs.h)
La structure FILE_FS_PERSISTENT_VOLUME_INFORMATION est utilisée pour contrôler les paramètres persistants d’un volume de système de fichiers. Les paramètres persistants persistent sur un volume de système de fichiers entre les redémarrages de l’ordinateur.
Syntaxe
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;
Membres
VolumeFlags
Paramètres d’état persistant pour un volume de système de fichiers. Cette valeur est une combinaison OR au niveau du bit des éléments suivants.
| Valeur | Signification |
|---|---|
| PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED 0x00000001 | La valeur 0 pour ce bit indique que la création de noms courts 8.3 est activée, et la valeur 1 indique que la création de noms courts est désactivée. 8.3 les noms de fichiers courts ont au maximum huit caractères, suivis d’un point « » et d’une extension de nom de fichier d’au plus trois caractères. |
| PERSISTENT_VOLUME_STATE_VOLUME_SCRUB_DISABLED 0x00000002 | Lorsqu’il est défini, cet indicateur indique que le nettoyage du volume est désactivé pour le volume. Valide à partir de Windows 8. |
| PERSISTENT_VOLUME_STATE_GLOBAL_METADATA_NO_SEEK_PENALTY 0x00000004 | La pénalité globale sans recherche est activée pour un volume hiérarchisé. Valide à partir de Windows 8.1. |
| PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY 0x00000008 | La pénalité locale sans recherche est activée pour un volume hiérarchisé. Valide à partir de Windows 8.1. |
| PERSISTENT_VOLUME_STATE_NO_HEAT_GATHERING 0x00000010 | Lorsqu’elle est définie, la collecte de chaleur n’est pas activée pour le volume hiérarchisé. Valide à partir de Windows 8.1. |
| PERSISTENT_VOLUME_STATE_CONTAINS_BACKING_WIM 0x00000020 | Indique que ce volume sauvegarde le volume système avec des fichiers d’un fichier WIM (Windows Image Format). Valide à partir de Mise à jour Windows 8.1. |
| PERSISTENT_VOLUME_STATE_BACKED_BY_WIM 0x00000040 | Indique que ce volume dépend d’un autre volume pour fournir des fichiers de démarrage critiques pour le système. L’autre volume contient un fichier WIM qui sauvegarde les fichiers sur ce volume. Cet indicateur est en lecture seule. Valide à partir de Mise à jour Windows 8.1. |
| PERSISTENT_VOLUME_STATE_DEV_VOLUME 0x00002000 | Indique que ce volume est mis en forme en tant que volume développeur. Cela peut être utilisé par le système de fichiers et d’autres composants système pour permettre des optimisations qui ne nécessitent pas qu’un administrateur approuve le volume sur une machine donnée. Valide à partir de Windows 11, version 22H2 Mise à jour de septembre. |
| PERSISTENT_VOLUME_STATE_TRUSTED_VOLUME 0x00004000 | Indique qu’un administrateur sur une machine donnée a approuvé ce volume et qu’il est prêt à activer des optimisations telles que l’attachement de filtres antivirus au volume. Ces informations sont conservées dans le Registre sur une machine donnée. Cela peut être utilisé par le système de fichiers et d’autres composants système pour permettre des optimisations qui nécessitent qu’un administrateur approuve le volume sur une machine donnée. Valide à partir de Windows 11, version 22H2 Mise à jour de septembre. |
FlagMask
Valeur de masque pour les indicateurs valides qui peuvent apparaître dans VolumeFlags. Il s’agit d’une combinaison OR au niveau du bit des indicateurs souhaités décrits pour VolumeFlags.
Version
Numéro de version de cette structure. défini sur 1.
Reserved
Réservé. Défini sur 0 ;
Remarques
La structure FILE_FS_PERSISTENT_VOLUME_INFORMATION est utilisée avec les codes de contrôle FSCTL_SET_PERSISTENT_VOLUME_STATE et FSCTL_QUERY_PERSISTENT_VOLUME_STATE .
Pour interroger les indicateurs d’état, FlagMask est défini sur une combinaison d’indicateurs à case activée. Par exemple, si les seuls indicateurs de pénalité recherchés sont intéressants, FlagMask = PERSISTENT_VOLUME_STATE_GLOBAL_METADATA_NO_SEEK_PENALTY | PERSISTENT_VOLUME_STATE_LOCAL_METADATA_NO_SEEK_PENALTY. En outre, si seule la prise en charge des noms courts est interrogée, définissez FlagMask = PERSISTENT_VOLUME_STATE_SHORT_NAME_CREATION_DISABLED.
Lors de la définition ou de l’effacement des indicateurs d’état du volume persistants, à l’aide de FSCTL_SET_PERSISTENT_VOLUME_STATE, FlagMask est défini sur tous les indicateurs dans VolumeFlags qui seront affectés pour le volume. VolumeFlags contient les indicateurs d’état persistants réels à définir pour le volume. L’exemple suivant montre comment définir les membres de FILE_FS_PERSISTENT_VOLUME_INFORMATION pour activer la création de noms courts pour un volume.
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 );
Le membre Version doit être défini sur la version actuelle de 1 pour une requête et une demande de jeu.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 |
| En-tête | ntifs.h (inclure Ntifs.h) |