FILE_FS_CONTROL_INFORMATION struttura (ntifs.h)
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).
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ntifs.h (include Ntifs.h, Fltkernel.h) |