Fonction FltQueryQuotaInformationFile (fltkernel.h)

Article
02/26/2024

La routine FltQueryQuotaInformationFile récupère les entrées de quota associées à un objet file.

Syntaxe

NTSTATUS FLTAPI FltQueryQuotaInformationFile(
  [in]            PFLT_INSTANCE    Instance,
  [in]            PFILE_OBJECT     FileObject,
  [out]           PIO_STATUS_BLOCK IoStatusBlock,
  [out]           PVOID            Buffer,
  [in]            ULONG            Length,
  [in]            BOOLEAN          ReturnSingleEntry,
  [in, optional]  PVOID            SidList,
  [in]            ULONG            SidListLength,
  [in, optional]  PULONG           StartSid,
  [in]            BOOLEAN          RestartScan,
  [out, optional] PULONG           LengthReturned
);

Paramètres

[in] Instance

Pointeur de instance opaque pour l’appelant. Ce paramètre est obligatoire et ne peut pas être NULL.

[in] FileObject

Pointeur d’objet fichier pour un fichier, un répertoire, un périphérique de stockage ou un volume ouvert. Ce paramètre est obligatoire et ne peut pas être NULL.

[out] IoStatusBlock

Un IO_STATUS_BLOCK fourni par l’appelant pour recevoir le résultat de l’appel à FltQueryQuotaInformationFile. Si l’appel échoue en raison d’une liste SID non valide, le champ Informations contient l’emplacement dans SidList où l’erreur s’est produite.

[out] Buffer

Pointeur vers une mémoire tampon d’entrée FILE_GET_QUOTA_INFORMATION structurée fournie par l’appelant où les valeurs d’informations de quota doivent être retournées.

[in] Length

Longueur, en octets, de la mémoire tampon vers laquelle pointe le paramètre Buffer .

[in] ReturnSingleEntry

Définissez sur TRUE si FltQueryQuotaInformationFile doit retourner uniquement la première entrée trouvée.

[in, optional] SidList

Pointeur vers une mémoire tampon d’entrée FILE_GET_QUOTA_INFORMATION structurée fournie par l’appelant qui spécifie les informations de quota à interroger. Ce paramètre est facultatif et peut être NULL.

[in] SidListLength

Longueur, en octets, de la mémoire tampon vers laquelle pointe le paramètre SidList .

[in, optional] StartSid

Index de l’entrée à laquelle commencer l’analyse de la liste d’informations de quota du fichier. Ce paramètre est ignoré si le paramètre SidList pointe vers une liste non vide. Ce paramètre est facultatif et peut être NULL.

[in] RestartScan

Défini sur TRUE si FltQueryQuotaInformationFile doit commencer l’analyse à la première entrée de la liste d’informations sur le quota du fichier. Si ce paramètre n’est pas défini sur TRUE, l’analyse reprend après un appel précédent à FltQueryQuotaInformationFile.

[out, optional] LengthReturned

Pointeur vers une variable allouée par l’appelant qui reçoit la taille, en octets, des informations retournées dans Buffer. Ce paramètre est facultatif et peut être NULL.

Valeur retournée

FltQueryQuotaInformationFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, telle que la suivante.

Code de retour	Description
STATUS_FLT_DELETING_OBJECT	Le instance ou le volume est détruit. Il s’agit d’un code d’erreur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
Plateforme cible	Universal
En-tête	fltkernel.h (inclure Fltkernel.h)
Bibliothèque	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Voir aussi

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile