MmCanFileBeTruncated, fonction (ntifs.h)

Article
12/22/2024

La routine MmCanFileBeTruncated vérifie si un fichier peut être tronqué.

Syntaxe

BOOLEAN MmCanFileBeTruncated(
  [in]           PSECTION_OBJECT_POINTERS SectionPointer,
  [in, optional] PLARGE_INTEGER           NewFileSize
);

Paramètres

[in] SectionPointer

Pointeur vers une structure qui contient les pointeurs d’objet de section de l’objet de fichier.

[in, optional] NewFileSize

Pointeur vers une variable qui spécifie la taille en octets vers laquelle le fichier doit être tronqué. Si ce paramètre a la valeur NULL, une longueur de zéro est supposée et MmCanFileBeTruncated vérifie si l’intégralité du fichier peut être tronquée.

Valeur de retour

MmCanFileBeTruncated retourne TRUE si le fichier peut être tronqué ; FALSE dans le cas contraire.

Remarques

mmCanFileBeTruncated doit toujours être appelée avant qu’un fichier ne soit tronqué.

Un fichier ne peut pas être tronqué (et MmCanFileBeTruncated retourne FALSE) si l’une des valeurs suivantes est vraie :

Une section image existe pour le fichier.
Il existe une ou plusieurs sondes d’écriture en attente dans la section de données du fichier.
Il existe une vue mappée de la section de données du fichier dans la plage de troncation déterminée par NewFileSize.
Un ou plusieurs utilisateurs contiennent des références à la section données du fichier, et NewFileSize<= la taille de fichier actuelle.