Fonction ZwSetQuotaInformationFile (ntifs.h)

Article
02/26/2024

La routine ZwSetQuotaInformationFile modifie les entrées de quota pour le volume associé au paramètre FileHandle . Toutes les entrées de quota dans la mémoire tampon spécifiée sont appliquées au volume.

Syntaxe

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

Paramètres

[in] FileHandle

Handle pour l’objet de fichier qui représente le fichier ou le volume pour lequel les informations de quota doivent être modifiées.

[out] IoStatusBlock

Adresse du bloc d’E/S de l’appelant status.

[in] Buffer

Mémoire tampon contenant les nouvelles entrées de quota qui doivent être appliquées au volume. Les informations de quota doivent être mises en forme sous forme d’une ou plusieurs structures FILE_QUOTA_INFORMATION . Le champ NextEntryOffset dans la structure FILE_QUOTA_INFORMATION contient le décalage, en octets, de l’entrée de quota suivante dans la liste. S’il n’y a plus d’entrées après celle actuelle, ce membre est égal à zéro.

[in] Length

Longueur en octets de la mémoire tampon.

Valeur retournée

La routine ZwSetQuotaInformationFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Code de retour	Description
STATUS_INSUFFICIENT_RESOURCES	Les ressources étaient insuffisantes pour terminer l’opération. Il s’agit d’un code d’erreur.
STATUS_INVALID_DEVICE_REQUEST	Les quotas ne sont pas activés sur le volume. Il s’agit d’un code d’erreur.
STATUS_MEDIA_WRITE_PROTECTED	Le volume est en lecture seule. Il s’agit d’un code d’erreur.

Remarques

La routine ZwSetQuotaInformationFile applique toutes les entrées de quota dans le paramètre Buffer spécifié au volume.

La fonction IoCheckQuotaBufferValidity peut case activée si la mémoire tampon de quota spécifiée passée en tant que paramètre Buffer est valide.

Un appel à ZwSetQuotaInformationFile entraîne l’envoi d’une requête IRP_MJ_SET_QUOTA à l’objet d’appareil associé à l’objet file dont le handle est stocké dans le paramètre FileHandle .

Si le système de fichiers sous-jacent ne prend pas en charge les informations de quota (systèmes de fichiers FAT et CDFS, par exemple), ZwSetQuotaInformationFile ne retourne pas STATUS_INVALID_DEVICE_REQUEST.

Notes

Si l’appel à la fonction ZwSetQuotaInformationFile se produit en mode utilisateur, vous devez utiliser le nom « NtSetQuotaInformationFile » au lieu de « ZwSetQuotaInformationFile ».

Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Utilisation des versions Nt et Zw des routines des services système natifs.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h, FltKernel.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm)