Funzione NtSetQuotaInformationFile (ntifs.h)

Articolo
02/29/2024

La routine NtSetQuotaInformationFile 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

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetQuotaInformationFile(
  [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 da applicare 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, espresso 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 NtSetQuotaInformationFile 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.

Commenti

La routine NtSetQuotaInformationFile applica tutte le voci quota nel parametro Buffer specificato al volume.

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

Una chiamata a NtSetQuotaInformationFile comporterà l'invio di una richiesta di 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), NtSetQuotaInformationFile non restituirà STATUS_INVALID_DEVICE_REQUEST.

Nota

Se la chiamata alla funzione NtSetQuotaInformationFile viene eseguita in modalità kernel, devi usare il nome "[ZwSetQuotaInformationFile](nf-ntifs-zwsetquotainformationfile.md" anziché "NtSetQuotaInformationFile".

Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows 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 .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Requisiti

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, PowerIrpDDis