structure FILE_FS_CONTROL_INFORMATION (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, nécessaire au démon Content-Indexing pour commencer le filtrage de documents.
FreeSpaceThreshold
Quantité minimale d’espace disque libre, en octets, requise pour que le service d’indexation continue de filtrer les documents et de fusionner des listes de mots. Si la quantité d’espace disque libre est inférieure à ce seuil, un message d’avertissement est écrit dans le journal des événements de l’application Microsoft Windows. Le filtrage et la fusion sont interrompus jusqu’à ce que l’espace soit libéré.
FreeSpaceStopFiltering
Quantité minimale d’espace disque disponible, en octets, nécessaire pour que le démon Content-Indexing continue le filtrage des documents. Si la quantité d’espace disque libre 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 effectue une entrée dans le journal des événements de l’application 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 de 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 sa limite de quota de disque affecté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 son seuil d’avertissement de quota 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 elle 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 | Si la valeur est définie, les quotas sont appliqués sur le volume. |
| FILE_VC_QUOTA_TRACK | S’il est défini, 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 | Si elle est définie, le système de fichiers reconstruit les informations de quota pour le volume. |
En outre, les masques d’indicateur suivants sont définis. Ils 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.
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 allouée par l’appelant, FILE_FS_CONTROL_INFORMATION structurée comme valeur de FileInformation.
- Créez un IRP avec le code de fonction principal IRP_MJ_SET_VOLUME_INFORMATION.
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
| En-tête | ntifs.h (include Ntifs.h, Fltkernel.h) |