estructura FILE_FS_CONTROL_INFORMATION (ntifs.h)
La estructura FILE_FS_CONTROL_INFORMATION se usa para consultar o establecer información de control para los archivos de un directorio.
Sintaxis
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;
Miembros
FreeSpaceStartFiltering
Cantidad mínima de espacio libre en disco, en bytes, necesario para que el demonio de indexación de contenido comience el filtrado de documentos.
FreeSpaceThreshold
Cantidad mínima de espacio libre en disco, en bytes, necesario para que el servicio de indexación continúe filtrando documentos y combinar listas de palabras. Si la cantidad de espacio libre en disco está por debajo de este umbral, se escribe un mensaje de advertencia en el registro de eventos de aplicación de Microsoft Windows. El filtrado y la combinación se detienen hasta que se libera espacio.
FreeSpaceStopFiltering
Cantidad mínima de espacio libre en disco, en bytes, necesario para que el demonio de indexación de contenido continúe con el filtrado de documentos. Si la cantidad de espacio libre en disco está por debajo de este umbral, se detiene el filtrado de documentos.
DefaultQuotaThreshold
Umbral de advertencia de cuota de disco por usuario predeterminado para el volumen.
DefaultQuotaLimit
Límite de cuota de disco por usuario predeterminado para el volumen.
FileSystemControlFlags
Máscara de bits de marcas que controlan el cumplimiento de cuotas y el registro de eventos de cuota relacionados con el usuario en el volumen. El registro realiza una entrada en el registro de eventos de la aplicación Windows. Combinación compatible de uno o varios de los siguientes elementos:
| Marca de control del sistema de archivos | Significado |
|---|---|
| FILE_VC_CONTENT_INDEX_DISABLED | Si se establece, la indexación de contenido está deshabilitada. |
| FILE_VC_LOG_QUOTA_LIMIT | Si se establece, se creará una entrada del registro de eventos cuando el usuario supere su límite de cuota de disco asignado. |
| FILE_VC_LOG_QUOTA_THRESHOLD | Si se establece, se creará una entrada del registro de eventos cuando el usuario supere su umbral de advertencia de cuota asignada. |
| FILE_VC_LOG_VOLUME_LIMIT | Si se establece, se creará una entrada del registro de eventos cuando se supere el límite de espacio libre del volumen. |
| FILE_VC_LOG_VOLUME_THRESHOLD | Si se establece, se creará una entrada de registro de eventos cuando se supere el umbral de espacio libre del volumen. |
| FILE_VC_QUOTA_ENFORCE | Si se establece, se aplican cuotas en el volumen. |
| FILE_VC_QUOTA_TRACK | Si se establece, se realiza un seguimiento de las cuotas en el volumen. |
| FILE_VC_QUOTAS_INCOMPLETE | Si se establece, la información de cuota del volumen está incompleta. |
| FILE_VC_QUOTAS_REBUILDING | Si se establece, el sistema de archivos vuelve a generar la información de cuota del volumen. |
Además, se definen las siguientes máscaras de marca. Son útiles para probar los valores de marca.
| Máscara | Valor |
|---|---|
| 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 | Combinación de ORed de todas las marcas de la tabla anterior. |
Comentarios
Esta información se puede consultar de cualquiera de las maneras siguientes:
Llame a FltQueryVolumeInformation o ZwQueryVolumeInformationFile, pasando FileFsControlInformation como valor de FileInformationClass y pasando un búfer asignado por el autor de la llamada, FILE_FS_CONTROL_INFORMATION estructurado como el valor de FileInformation.
Cree un IRP con el código de función principal IRP_MJ_QUERY_VOLUME_INFORMATION.
FILE_READ_DATA se requiere acceso al volumen para consultar esta información.
Esta información se puede establecer de cualquiera de las siguientes maneras:
- Llame a FltSetVolumeInformation o ZwSetVolumeInformationFile, pasando FileFsControlInformation como valor de FileInformationClass y pasando un búfer asignado por el autor de la llamada FILE_FS_CONTROL_INFORMATION como valor de FileInformation.
- Cree un IRP con el código de función principal IRP_MJ_SET_VOLUME_INFORMATION.
FILE_WRITE_DATA se requiere acceso al volumen para establecer esta información.
El tamaño del búfer pasado en el parámetro FileInformation a FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile o ZwSetVolumeInformationFile debe ser al menos sizeof (FILE_FS_CONTROL_INFORMATION).
Esta estructura debe alinearse en un límite de LONGLONG (8 bytes).
Requisitos
| Requisito | Valor |
|---|---|
| Header | ntifs.h (incluya Ntifs.h, Fltkernel.h) |