Função ZwQueryQuotaInformationFile (ntifs.h)

Artigo
12/21/2024

A rotina de ZwQueryQuotaInformationFile recupera entradas de cota associadas ao volume especificado pelo parâmetro FileHandle.

Sintaxe

NTSYSAPI NTSTATUS ZwQueryQuotaInformationFile(
  [in]           HANDLE           FileHandle,
  [out]          PIO_STATUS_BLOCK IoStatusBlock,
  [out]          PVOID            Buffer,
  [in]           ULONG            Length,
  [in]           BOOLEAN          ReturnSingleEntry,
  [in, optional] PVOID            SidList,
  [in]           ULONG            SidListLength,
  [in, optional] PSID             StartSid,
  [in]           BOOLEAN          RestartScan
);

Parâmetros

[in] FileHandle

Um identificador para o objeto de arquivo que representa o arquivo ou volume para o qual as informações de cota são solicitadas.

[out] IoStatusBlock

O endereço do bloco de status de E/S do chamador.

[out] Buffer

Um buffer para receber as informações de cota do volume. As informações de cota são formatadas como uma ou mais estruturas de FILE_QUOTA_INFORMATION. O campo NextEntryOffset na estrutura FILE_QUOTA_INFORMATION contém o deslocamento, em bytes, da próxima entrada de cota na lista. Se não houver mais entradas após a atual, esse membro será zero.

[in] Length

O comprimento em bytes do buffer.

[in] ReturnSingleEntry

Um valor booliano que indica se apenas uma única entrada deve ser retornada em vez de preencher o buffer com o máximo de entradas possível.

[in, optional] SidList

Uma lista opcional de SIDs cujas informações de cota devem ser retornadas. Cada entrada na lista é uma estrutura FILE_GET_QUOTA_INFORMATION. O campo NextEntryOffset na estrutura FILE_GET_QUOTA_INFORMATION contém o deslocamento, em bytes, da próxima entrada de cota na lista. Se não houver mais entradas após a atual, esse membro será zero.

[in] SidListLength

O comprimento em bytes da lista de sid , se um tiver sido especificado.

[in, optional] StartSid

Um ponteiro opcional para o SID da entrada na qual começar a verificar as informações de cota. Esse parâmetro deve ser definido se as informações retornadas forem iniciadas com uma entrada diferente da primeira SID. Esse parâmetro será ignorado se um parâmetro SidList for especificado.

[in] RestartScan

Um valor booliano que indica se a verificação das informações de cota deve ser reiniciada desde o início. Defina esse parâmetro como VERDADEIRO se a verificação das informações de cota for iniciar na primeira entrada na lista de informações de cota do volume. Defina como FALSE se retomar a verificação de uma chamada anterior para ZwQueryQuotaInformationFile . O chamador deve definir esse parâmetro para TRUE ao chamar ZwQueryQuotaInformationFile pela primeira vez.

Valor de retorno

A rotina ZwQueryQuotaInformationFile retornará STATUS_SUCCESS se pelo menos uma estrutura FILE_QUOTA_INFORMATION for retornada no parâmetro do Buffer ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_INSUFFICIENT_RESOURCES	Não havia recursos suficientes para concluir a operação. Este é um código de erro.
STATUS_INVALID_DEVICE_REQUEST	As cotas não estão habilitadas no volume. Este é um código de erro.
STATUS_INVALID_SID	O parâmetro StartSid do não continha umade SID de válida. Este é um código de erro.
STATUS_QUOTA_LIST_INCONSISTENT	O parâmetro SidList não continha uma lista válida e corretamente formada. Este é um código de erro.

Observações

A quantidade de informações retornadas por ZwQueryQuotaInformationFile baseia-se no tamanho das informações de cota associadas ao volume, ao tamanho do buffer e se um conjunto específico de entradas foi solicitado.

Uma chamada para ZwQueryQuotaInformationFile resultará em uma solicitação IRP_MJ_SET_QUOTA sendo enviada ao objeto do dispositivo associado ao objeto de arquivo cujo identificador está armazenado no parâmetro FileHandle .

Se o sistema de arquivos subjacente não der suporte a informações de cota (sistemas de arquivos FAT e CDFS, por exemplo), ZwQueryQuotaInformationFile falhará ao retornar STATUS_INVALID_DEVICE_REQUEST.

Nota

Se a chamada para a função ZwQueryQuotaInformationFile ocorrer no modo de usuário, você deverá usar o nome "NtQueryQuotaInformationFile" em vez de "ZwQueryQuotaInformationFile".

Para chamadas de drivers no modo kernel, as versões NtXxx e Zwxxx versões de uma rotina dos Serviços de Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas de serviços do sistema nativo.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 7
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h, FltKernel.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)