FltQueryQuotaInformationFile, fonction (fltkernel.h)

Article
02/06/2025

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

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 d’instance opaque pour l’appelant. Ce paramètre est obligatoire et ne peut pas être NULL.

[in] FileObject

Pointeur d’objet de fichier pour un fichier ouvert, un répertoire, un appareil de stockage ou un volume. 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 de contient l’emplacement dans SidList où l’erreur s’est produite.

[out] Buffer

Pointeur vers une FILE_GET_QUOTA_INFORMATIONmémoire tampon d’entrée 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 tampon.

[in] ReturnSingleEntry

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

[in, optional] SidList

Pointeur vers une FILE_GET_QUOTA_INFORMATIONmémoire tampon d’entrée 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 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 de quota du fichier. Si ce paramètre n’est pas défini sur TRUE, l’analyse est reprise à partir d’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 tampon. Ce paramètre est facultatif et peut être NULL.

Valeur de retour

FltQueryQuotaInformationFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple.

Retourner le code	Description
STATUS_FLT_DELETING_OBJECT	L’instance ou le volume est détruit. Il s’agit d’un code d’erreur.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 8.
plateforme cible	Universel
d’en-tête	fltkernel.h (include Fltkernel.h)
bibliothèque	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Voir aussi

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile

Partager via