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 cae por debajo de este umbral, se escribe un mensaje de advertencia en el registro de eventos de la 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, que es necesario para que el demonio de indexación de contenido continúe filtrando 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 la aplicación 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 una o varias de las siguientes opciones:
| 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 el 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 del 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 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. |
Observaciones
Esta información se puede consultar de cualquiera de las maneras siguientes:
Llame a FltQueryVolumeInformation o ZwQueryVolumeInformationFile, pasando FileFsControlInformation como el valor de fileInformationClass y pasando un búfer asignado por el autor de la llamada FILE_FS_CONTROL_INFORMATION como el valor de FileInformation.
Cree un IRP con IRP_MJ_QUERY_VOLUME_INFORMATION de código de función principal.
FILE_READ_DATA acceso al volumen es necesario para consultar esta información.
Esta información se puede establecer de cualquiera de las maneras siguientes:
- 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-structured como el valor de FileInformation.
- Cree un IRP con IRP_MJ_SET_VOLUME_INFORMATION de código de función principal.
FILE_WRITE_DATA acceso al volumen es necesario para establecer esta información.
El tamaño del búfer pasado en el parámetro FileInformation a FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFileo ZwSetVolumeInformationFile debe ser al menos tamaño de (FILE_FS_CONTROL_INFORMATION).
Esta estructura debe alinearse en un límite de LONGLONG (8 bytes).
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de |
ntifs.h (incluya Ntifs.h, Fltkernel.h) |