estrutura FILE_FS_CONTROL_INFORMATION (ntifs.h)

Artigo
09/27/2023

A estrutura FILE_FS_CONTROL_INFORMATION é usada para consultar ou definir informações de controle para os arquivos em um diretório.

Sintaxe

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;

Membros

FreeSpaceStartFiltering

Quantidade mínima de espaço livre em disco, em bytes, necessária para que o daemon Content-Indexing inicie a filtragem de documentos.

FreeSpaceThreshold

Quantidade mínima de espaço livre em disco, em bytes, necessária para que o Serviço de Indexação continue a filtrar documentos e mesclar listas de palavras. Se a quantidade de espaço livre em disco ficar abaixo desse limite, uma mensagem de aviso será gravada no log de eventos do aplicativo Microsoft Windows. A filtragem e a mesclagem são interrompidas até que o espaço seja liberado.

FreeSpaceStopFiltering

Quantidade mínima de espaço livre em disco, em bytes, necessária para que o daemon Content-Indexing continue a filtragem de documentos. Se a quantidade de espaço livre em disco ficar abaixo desse limite, a filtragem de documentos será interrompida.

DefaultQuotaThreshold

Limite de aviso de cota de disco por usuário padrão para o volume.

DefaultQuotaLimit

Limite de cota de disco por usuário padrão para o volume.

FileSystemControlFlags

Máscara de bits de sinalizadores que controlam a imposição de cota e o registro em log de eventos de cota relacionados ao usuário no volume. O registro em log faz uma entrada no log de eventos do aplicativo do Windows. Combinação compatível de uma ou mais das seguintes opções:

Sinalizador de controle do sistema de arquivos	Significado
FILE_VC_CONTENT_INDEX_DISABLED	Se definido, a indexação de conteúdo será desabilitada.
FILE_VC_LOG_QUOTA_LIMIT	Se definida, uma entrada de log de eventos será criada quando o usuário exceder o limite de cota de disco atribuído.
FILE_VC_LOG_QUOTA_THRESHOLD	Se definido, uma entrada de log de eventos será criada quando o usuário exceder o limite de aviso de cota atribuído.
FILE_VC_LOG_VOLUME_LIMIT	Se definida, uma entrada de log de eventos será criada quando o limite de espaço livre do volume for excedido.
FILE_VC_LOG_VOLUME_THRESHOLD	Se definido, uma entrada de log de eventos será criada quando o limite de espaço livre do volume for excedido.
FILE_VC_QUOTA_ENFORCE	Se definido, as cotas serão impostas no volume.
FILE_VC_QUOTA_TRACK	Se definido, as cotas serão controladas no volume.
FILE_VC_QUOTAS_INCOMPLETE	Se definido, as informações de cota para o volume estão incompletas.
FILE_VC_QUOTAS_REBUILDING	Se definido, o sistema de arquivos está recompilando as informações de cota para o volume.

Além disso, as máscaras de sinalizador a seguir são definidas. Eles são úteis para testar valores de sinalizador.

Mask	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	Combinação ORed de todos os sinalizadores na tabela acima.

Comentários

Essas informações podem ser consultadas de uma das seguintes maneiras:

Chame FltQueryVolumeInformation ou ZwQueryVolumeInformationFile, passando FileFsControlInformation como o valor de FileInformationClass e passando um buffer alocado pelo chamador FILE_FS_CONTROL_INFORMATION estruturado como o valor de FileInformation.
Crie um IRP com o código de função principal IRP_MJ_QUERY_VOLUME_INFORMATION.

FILE_READ_DATA acesso ao volume é necessário para consultar essas informações.

Essas informações podem ser definidas de qualquer uma das seguintes maneiras:

Chame FltSetVolumeInformation ou ZwSetVolumeInformationFile, passando FileFsControlInformation como o valor de FileInformationClass e passando um buffer alocado pelo chamador FILE_FS_CONTROL_INFORMATION estruturado como o valor de FileInformation.
Crie um IRP com o código de função principal IRP_MJ_SET_VOLUME_INFORMATION.

FILE_WRITE_DATA acesso ao volume é necessário para definir essas informações.

O tamanho do buffer passado no parâmetro FileInformation para FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile ou ZwSetVolumeInformationFile deve ser pelo menos sizeof (FILE_FS_CONTROL_INFORMATION).

Essa estrutura deve ser alinhada em um limite LONGLONG (8 bytes).