FILE_FS_CONTROL_INFORMATION structure (ntifs.h)
La structure FILE_FS_CONTROL_INFORMATION est utilisée pour interroger ou définir des informations de contrôle pour les fichiers d’un répertoire.
Syntaxe
typedef struct _FILE_FS_CONTROL_INFORMATION {
LARGE_INTEGER FreeSpaceStartFiltering;
LARGE_INTEGER FreeSpaceThreshold;
LARGE_INTEGER FreeSpaceStopFiltering;
LARGE_INTEGER DefaultQuotaThreshold;
LARGE_INTEGER DefaultQuotaLimit;
ULONG FileSystemControlFlags;
} FILE_FS_CONTROL_INFORMATION, *PFILE_FS_CONTROL_INFORMATION;
Membres
FreeSpaceStartFiltering
Quantité minimale d’espace disque disponible, en octets, requise pour que le démon d’indexation de contenu commence le filtrage des documents.
FreeSpaceThreshold
Quantité minimale d’espace disque libre, en octets, requise pour que le service d’indexation continue à filtrer les documents et à fusionner des listes de mots. Si la quantité d’espace disque disponible est inférieure à ce seuil, un message d’avertissement est écrit dans le journal des événements des applications Microsoft Windows. Le filtrage et la fusion sont arrêtés jusqu’à ce que l’espace soit libéré.
FreeSpaceStopFiltering
Quantité minimale d’espace disque libre, en octets, requise pour que le démon d’indexation du contenu poursuive le filtrage des documents. Si la quantité d’espace disque disponible est inférieure à ce seuil, le filtrage des documents est arrêté.
DefaultQuotaThreshold
Seuil d’avertissement de quota de disque par utilisateur par défaut pour le volume.
DefaultQuotaLimit
Limite de quota de disque par utilisateur par défaut pour le volume.
FileSystemControlFlags
Masque de bits des indicateurs qui contrôlent l’application du quota et la journalisation des événements de quota liés à l’utilisateur sur le volume. La journalisation crée une entrée dans le journal des événements des applications Windows. Combinaison compatible d’une ou plusieurs des options suivantes :
| Indicateur de contrôle du système de fichiers | Signification |
|---|---|
| FILE_VC_CONTENT_INDEX_DISABLED | Si elle est définie, l’indexation du contenu est désactivée. |
| FILE_VC_LOG_QUOTA_LIMIT | Si elle est définie, une entrée de journal des événements est créée lorsque l’utilisateur dépasse la limite de quota de disque qui lui est attribuée. |
| FILE_VC_LOG_QUOTA_THRESHOLD | Si elle est définie, une entrée de journal des événements est créée lorsque l’utilisateur dépasse le seuil d’avertissement du quota qui lui est attribué. |
| FILE_VC_LOG_VOLUME_LIMIT | Si elle est définie, une entrée de journal des événements est créée lorsque la limite d’espace libre du volume est dépassée. |
| FILE_VC_LOG_VOLUME_THRESHOLD | Si cette option est définie, une entrée de journal des événements est créée lorsque le seuil d’espace libre du volume est dépassé. |
| FILE_VC_QUOTA_ENFORCE | S’il est défini, des quotas sont appliqués sur le volume. |
| FILE_VC_QUOTA_TRACK | S’ils sont définis, les quotas sont suivis sur le volume. |
| FILE_VC_QUOTAS_INCOMPLETE | Si elle est définie, les informations de quota pour le volume sont incomplètes. |
| FILE_VC_QUOTAS_REBUILDING | S’il est défini, le système de fichiers régénère les informations de quota pour le volume. |
En outre, les masques d’indicateur suivants sont définis. Celles-ci sont utiles pour tester les valeurs d’indicateur.
| Mask | Valeur |
|---|---|
| FILE_VC_QUOTA_MASK | FILE_VC_QUOTA_ENFORCE | FILE_VC_QUOTA_TRACK |
| FILE_VC_QUOTA_NONE | ~FILE_VC_QUOTA_ENFORCE & ~FILE_VC_QUOTA_TRACK |
| FILE_VC_VALID_MASK | Combinaison ORed de tous les indicateurs du tableau ci-dessus. |
Remarques
Ces informations peuvent être interrogées de l’une des manières suivantes :
Appelez FltQueryVolumeInformation ou ZwQueryVolumeInformationFile, en passant FileFsControlInformation comme valeur de FileInformationClass et en transmettant une mémoire tampon FILE_FS_CONTROL_INFORMATION structurée par l’appelant comme valeur de FileInformation.
Créez un IRP avec le code de fonction principal IRP_MJ_QUERY_VOLUME_INFORMATION.
FILE_READ_DATA l’accès au volume est nécessaire pour interroger ces informations.
Ces informations peuvent être définies de l’une des manières suivantes :
- Appelez FltSetVolumeInformation ou ZwSetVolumeInformationFile, en passant FileFsControlInformation comme valeur de FileInformationClass et en passant une mémoire tampon FILE_FS_CONTROL_INFORMATION-structurée par l’appelant comme valeur de FileInformation.
- Créez un IRP avec le code de fonction principal IRP_MJ_SET_VOLUME_INFORMATION.
FILE_WRITE_DATA’accès au volume est nécessaire pour définir ces informations.
La taille de la mémoire tampon passée dans le paramètre FileInformation à FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile ou ZwSetVolumeInformationFile doit être au moins sizeof (FILE_FS_CONTROL_INFORMATION).
Cette structure doit être alignée sur une limite LONGLONG (8 octets).
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ntifs.h (include Ntifs.h, Fltkernel.h) |