estructura FILE_FS_CONTROL_INFORMATION (ntifs.h)

Artículo
01/10/2024

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).