Funzione ZwQueryQuotaInformationFile (ntifs.h)

Articolo
12/21/2024

La routine ZwQueryQuotaInformationFile recupera le voci di quota associate al volume specificato dal parametro FileHandle.

Sintassi

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
);

Parametri

[in] FileHandle

Handle per l'oggetto file che rappresenta il file o il volume per cui vengono richieste le informazioni sulla quota.

[out] IoStatusBlock

Indirizzo del blocco di stato di I/O del chiamante.

[out] Buffer

Buffer per ricevere le informazioni sulla quota per il volume. Le informazioni sulla quota vengono formattate come una o più strutture FILE_QUOTA_INFORMATION. Il campo NextEntryOffset nella struttura FILE_QUOTA_INFORMATION contiene l'offset, in byte, della voce di quota successiva nell'elenco. Se non sono presenti più voci dopo quella corrente, questo membro è zero.

[in] Length

Lunghezza in byte del buffer.

[in] ReturnSingleEntry

Valore booleano che indica se deve essere restituita una sola voce anziché riempire il buffer con il maggior numero possibile di voci.

[in, optional] SidList

Elenco facoltativo di SID le cui informazioni sulla quota devono essere restituite. Ogni voce nell'elenco è una struttura FILE_GET_QUOTA_INFORMATION. Il campo NextEntryOffset nella struttura FILE_GET_QUOTA_INFORMATION contiene l'offset, in byte, della voce di quota successiva nell'elenco. Se non sono presenti più voci dopo quella corrente, questo membro è zero.

[in] SidListLength

Lunghezza in byte dell'elenco di SID, se specificato.

[in, optional] StartSid

Puntatore facoltativo al SID della voce in cui iniziare a analizzare le informazioni sulla quota. Questo parametro deve essere impostato se le informazioni restituite devono iniziare con una voce diversa dal primo SID. Questo parametro viene ignorato se viene specificato un parametro SidList .

[in] RestartScan

Valore booleano che indica se l'analisi delle informazioni sulla quota deve essere riavviata dall'inizio. Impostare questo parametro su TRUE se l'analisi delle informazioni sulla quota deve iniziare dalla prima voce nell'elenco delle informazioni sulla quota del volume. Impostare su false se riprende l'analisi da una chiamata precedente a ZwQueryQuotaInformationFile. Il chiamante deve impostare questo parametro su TRUE quando si chiama ZwQueryQuotaInformationFile per la prima volta.

Valore restituito

La routine ZwQueryQuotaInformationFile restituisce STATUS_SUCCESS se almeno una struttura FILE_QUOTA_INFORMATION viene restituita nel parametro buffer o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	Risorse insufficienti per completare l'operazione. Si tratta di un codice di errore.
STATUS_INVALID_DEVICE_REQUEST	Le quote non sono abilitate nel volume. Si tratta di un codice di errore.
STATUS_INVALID_SID	Il parametro StartSid non contiene un SID valido. Si tratta di un codice di errore.
STATUS_QUOTA_LIST_INCONSISTENT	Il parametro SidList non contiene un elenco valido e correttamente formato. Si tratta di un codice di errore.

Osservazioni

La quantità di informazioni restituite da ZwQueryQuotaInformationFile si basa sulle dimensioni delle informazioni sulla quota associate al volume, sulle dimensioni del buffer e sul fatto che sia stato richiesto un set specifico di voci.

Una chiamata a ZwQueryQuotaInformationFile comporterà l'invio di una richiesta IRP_MJ_SET_QUOTA all'oggetto dispositivo associato all'oggetto file il cui handle viene archiviato nel parametro FileHandle.

Se il file system sottostante non supporta le informazioni sulla quota (ad esempio file system FAT e CDFS), ZwQueryQuotaInformationFile restituirà STATUS_INVALID_DEVICE_REQUEST.

Nota

Se la chiamata alla funzione ZwQueryQuotaInformationFile viene eseguita in modalità utente, è necessario usare il nome "NtQueryQuotaInformationFile" anziché "ZwQueryQuotaInformationFile".

Per le chiamate da driver in modalità kernel, le NtXxx e ZwXxx versioni di una routine di Windows Native System Services possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 7
piattaforma di destinazione	Universale
intestazione	ntifs.h (include Ntifs.h, FltKernel.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regole di conformità DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)