Funzione ZwSetQuotaInformationFile (ntifs.h)

Articolo
12/22/2024

Il ZwSetQuotaInformationFile routine modifica le voci di quota per il volume associato al parametro FileHandle. Tutte le voci di quota nel buffer specificato vengono applicate al volume.

Sintassi

NTSYSAPI NTSTATUS ZwSetQuotaInformationFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PVOID            Buffer,
  [in]  ULONG            Length
);

Parametri

[in] FileHandle

Handle per l'oggetto file che rappresenta il file o il volume per cui devono essere modificate le informazioni sulla quota.

[out] IoStatusBlock

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

[in] Buffer

Buffer contenente le nuove voci di quota che devono essere applicate al volume. Le informazioni sulla quota devono essere 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.

Valore restituito

La routine ZwSetQuotaInformationFile restituisce STATUS_SUCCESS 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_MEDIA_WRITE_PROTECTED	Il volume è di sola lettura. Si tratta di un codice di errore.

Osservazioni

La routine ZwSetQuotaInformationFile applica tutte le voci di quota nel parametro buffer specificato al volume.

La funzione IoCheckQuotaBufferValidity può verificare se il buffer di quota specificato passato come parametro buffer buffer è valido.

Una chiamata a ZwSetQuotaInformationFile 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 sulle quote (ad esempio file system FAT e CDFS), ZwSetQuotaInformationFile non riuscirà a restituire STATUS_INVALID_DEVICE_REQUEST.

Nota

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

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)