struttura FILE_FS_CONTROL_INFORMATION (ntifs.h)
La struttura FILE_FS_CONTROL_INFORMATION viene utilizzata 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;
Membri
FreeSpaceStartFiltering
Quantità minima di spazio libero su disco, in byte, necessaria per il daemon Content-Indexing per avviare il filtro dei documenti.
FreeSpaceThreshold
Quantità minima di spazio libero su disco, in byte, necessaria per il servizio di indicizzazione per continuare a filtrare i documenti e unire elenchi di parole. Se la quantità di spazio libero su disco scende al di sotto di questa soglia, viene scritto un messaggio di avviso nel registro eventi dell'applicazione di Microsoft Windows. I filtri e l'unione vengono interrotti fino a quando lo spazio non viene liberato.
FreeSpaceStopFiltering
Quantità minima di spazio libero su disco, in byte, necessaria per il daemon Content-Indexing per continuare a filtrare i documenti. Se la quantità di spazio libero su disco scende al di sotto di questa soglia, il filtro dei documenti viene interrotto.
DefaultQuotaThreshold
Soglia di avviso predefinita per la quota del disco per utente per il volume.
DefaultQuotaLimit
Limite di quota predefinita per disco per utente per il volume.
FileSystemControlFlags
Maschera di bit di flag che controllano l'applicazione della quota e la registrazione di eventi di quota correlati all'utente nel volume. La registrazione crea una voce nel registro eventi dell'applicazione di Windows. Combinazione compatibile di una o più delle opzioni seguenti:
| 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 relativa alla quota assegnata. |
| FILE_VC_LOG_VOLUME_LIMIT | Se impostato, verrà creata una voce del registro eventi quando viene superato il limite di spazio disponibile 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 al 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. |
Vengono inoltre definite le maschere di flag seguenti. Sono utili per testare i valori dei flag.
| Maschera | 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. |
Osservazioni
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 strutturato come valore di FileInformation.
Creare un IRP con il 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 funzione principale IRP_MJ_SET_VOLUME_INFORMATION.
FILE_WRITE_DATA'accesso al volume è necessario per impostare queste informazioni.
Le dimensioni del buffer passate nel parametro
Questa struttura deve essere allineata su un limite LONGLONG (8 byte).
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione |
ntifs.h (include Ntifs.h, Fltkernel.h) |