FILE_FS_CONTROL_INFORMATION struttura (ntifs.h)

Articolo
09/27/2023

La struttura FILE_FS_CONTROL_INFORMATION viene usata per eseguire query o impostare le informazioni di controllo per i file in una directory.

Sintassi

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;

Members

FreeSpaceStartFiltering

Quantità minima di spazio su disco libero, in byte, necessaria per il daemon Content-Indexing per avviare il filtro dei documenti.

FreeSpaceThreshold

Quantità minima di spazio su disco libero, in byte, necessaria per il servizio di indicizzazione per continuare a filtrare documenti e elenchi di parole di tipo merge. Se la quantità di spazio su disco libero scende al di sotto di questa soglia, viene scritto un messaggio di avviso nel registro eventi dell'applicazione Microsoft Windows. Il filtro e l'unione vengono arrestati fino a quando lo spazio non viene liberato.

FreeSpaceStopFiltering

Quantità minima di spazio su disco libero, in byte, necessaria per il daemon Content-Indexing per continuare il filtro dei documenti. Se la quantità di spazio libero su disco scende al di sotto di questa soglia, il filtro dei documenti viene arrestato.

DefaultQuotaThreshold

Soglia di avviso della quota di disco per utente predefinita per il volume.

DefaultQuotaLimit

Limite predefinito della quota del disco per utente per il volume.

FileSystemControlFlags

Maschera di flag che controllano l'imposizione delle quote e la registrazione degli eventi di quota correlati all'utente nel volume. La registrazione effettua una voce nel registro eventi dell'applicazione Windows. Combinazione compatibile di uno o più dei seguenti elementi:

Flag di controllo del file system	Significato
FILE_VC_CONTENT_INDEX_DISABLED	Se impostato, l'indicizzazione del contenuto è disabilitata.
FILE_VC_LOG_QUOTA_LIMIT	Se impostata, verrà creata una voce del registro eventi quando l'utente supera il limite di quota del disco assegnato.
FILE_VC_LOG_QUOTA_THRESHOLD	Se impostata, verrà creata una voce del registro eventi quando l'utente supera la soglia di avviso della quota assegnata.
FILE_VC_LOG_VOLUME_LIMIT	Se impostato, viene creata una voce del registro eventi quando viene superato il limite di spazio libero del volume.
FILE_VC_LOG_VOLUME_THRESHOLD	Se impostata, verrà creata una voce del registro eventi quando viene superata la soglia di spazio disponibile del volume.
FILE_VC_QUOTA_ENFORCE	Se impostata, le quote vengono applicate nel volume.
FILE_VC_QUOTA_TRACK	Se impostata, le quote vengono rilevate nel volume.
FILE_VC_QUOTAS_INCOMPLETE	Se impostata, le informazioni sulla quota per il volume sono incomplete.
FILE_VC_QUOTAS_REBUILDING	Se impostato, il file system ricompila le informazioni sulla quota per il volume.

Sono inoltre definite le maschere di flag seguenti. Questi sono utili per testare i valori del flag.

Mask	Valore
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	Combinazione ORed di tutti i flag nella tabella precedente.

Commenti

Queste informazioni possono essere sottoposte a query in uno dei modi seguenti:

Chiamare FltQueryVolumeInformation o ZwQueryVolumeInformationFile, passando FileFsControlInformation come valore di FileInformationClass e passando un buffer allocato dal chiamante FILE_FS_CONTROL_INFORMATION strutturata come valore di FileInformation.
Creare un'istanza di IRP con codice di funzione principale IRP_MJ_QUERY_VOLUME_INFORMATION.

FILE_READ_DATA l'accesso al volume è necessario per eseguire query su queste informazioni.

Queste informazioni possono essere impostate in uno dei modi seguenti:

Chiamare FltSetVolumeInformation o ZwSetVolumeInformationFile, passando FileFsControlInformation come valore di FileInformationClass e passando un buffer allocato dal chiamante FILE_FS_CONTROL_INFORMATION strutturato come valore di FileInformation.
Creare un'IRP con codice di funzione principale IRP_MJ_SET_VOLUME_INFORMATION.

FILE_WRITE_DATA l'accesso al volume è necessario per impostare queste informazioni.

Le dimensioni del buffer passate nel parametro FileInformation a FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile o ZwSetVolumeInformationFile devono essere almeno sizeof (FILE_FS_CONTROL_INFORMATION).

Questa struttura deve essere allineata a un limite LONGLONG (8 byte).