Funzione ZwSetQuotaInformationFile (ntifs.h)

Articolo
02/26/2024

La routine ZwSetQuotaInformationFile 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	Per completare l'operazione sono state eseguite risorse insufficienti. 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 ZwSetQuotaInformationFile applica tutte le voci di quota nel parametro Buffer specificato al volume.

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

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

Nota

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

Per le chiamate dai driver in modalità kernel, le versioni NtXxx e ZwXxx 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 Uso di nt e zw versioni delle routine di Servizi di sistema nativo.

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(storport), PowerIrpDDis(wdm)