Função FltQueryQuotaInformationFile (fltkernel.h)

Artigo
03/01/2024

A rotina FltQueryQuotaInformationFile recupera entradas de cota associadas a um objeto de arquivo.

Sintaxe

NTSTATUS FLTAPI FltQueryQuotaInformationFile(
  [in]            PFLT_INSTANCE    Instance,
  [in]            PFILE_OBJECT     FileObject,
  [out]           PIO_STATUS_BLOCK IoStatusBlock,
  [out]           PVOID            Buffer,
  [in]            ULONG            Length,
  [in]            BOOLEAN          ReturnSingleEntry,
  [in, optional]  PVOID            SidList,
  [in]            ULONG            SidListLength,
  [in, optional]  PULONG           StartSid,
  [in]            BOOLEAN          RestartScan,
  [out, optional] PULONG           LengthReturned
);

Parâmetros

[in] Instance

Um ponteiro de instância opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL.

[in] FileObject

Um ponteiro de objeto de arquivo para um arquivo aberto, diretório, dispositivo de armazenamento ou volume. Esse parâmetro é necessário e não pode ser NULL.

[out] IoStatusBlock

Um IO_STATUS_BLOCK fornecido pelo chamador para receber o resultado da chamada para FltQueryQuotaInformationFile. Se a chamada falhar devido a uma lista sid inválida, o campo Informações conterá o local em SidList em que o erro ocorreu.

[out] Buffer

Um ponteiro para um buffer de entrada FILE_GET_QUOTA_INFORMATION estruturado pelo chamador em que os valores de informações de cota devem ser retornados.

[in] Length

O comprimento, em bytes, do buffer para o qual o parâmetro Buffer aponta.

[in] ReturnSingleEntry

Defina como TRUE se FltQueryQuotaInformationFile retornar apenas a primeira entrada encontrada.

[in, optional] SidList

Um ponteiro para um buffer de entrada FILE_GET_QUOTA_INFORMATION estruturado pelo chamador que especifica as informações de cota a serem consultadas. Esse parâmetro é opcional e pode ser NULL.

[in] SidListLength

O comprimento, em bytes, do buffer para o qual o parâmetro SidList aponta.

[in, optional] StartSid

O índice da entrada na qual começar a verificar a lista de informações de cota do arquivo. Esse parâmetro será ignorado se o parâmetro SidList apontar para uma lista não vazia. Esse parâmetro é opcional e pode ser NULL.

[in] RestartScan

Defina como TRUE se FltQueryQuotaInformationFile deve iniciar a verificação na primeira entrada na lista de informações de cota do arquivo. Se esse parâmetro não estiver definido como TRUE, a verificação será retomada de uma chamada anterior para FltQueryQuotaInformationFile.

[out, optional] LengthReturned

Um ponteiro para uma variável alocada pelo chamador que recebe o tamanho, em bytes, das informações retornadas em Buffer. Esse parâmetro é opcional e pode ser NULL.

Retornar valor

FltQueryQuotaInformationFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte.

Código de retorno	Descrição
STATUS_FLT_DELETING_OBJECT	A instância ou o volume está sendo dividido. Este é um código de erro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 8.
Plataforma de Destino	Universal
Cabeçalho	fltkernel.h (inclua Fltkernel.h)
Biblioteca	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Confira também

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile

Compartilhar via