estrutura FILE_FS_CONTROL_INFORMATION (ntifs.h)
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, que é 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 estiver 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, que é necessária para que o daemon de Indexação de Conteúdo 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 cotas 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 Windows. Combinação compatível de um ou mais dos seguintes:
| 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 definido, 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 definido, 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 do volume estão incompletas. |
| FILE_VC_QUOTAS_REBUILDING | Se definido, o sistema de arquivos está recriando as informações de cota para o volume. |
Além disso, as máscaras de sinalizador a seguir são definidas. Elas são úteis para testar valores de sinalizador.
| 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 | Combinação ORed de todos os sinalizadores na tabela acima. |
Observações
Essas informações podem ser consultadas de qualquer uma das seguintes maneiras:
Chame FltQueryVolumeInformation ou ZwQueryVolumeInformationFile, passando FileFsControlInformation como o valor de FileInformationClass e passando um buffer alocado por um chamador, estruturado FILE_FS_CONTROL_INFORMATION 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 FileInformationClass e passando um buffer alocado por 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
Essa estrutura deve ser alinhada em um limite LONGLONG (8 bytes).
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | ntifs.h (inclua Ntifs.h, Fltkernel.h) |