Fonction MmCanFileBeTruncated (ntifs.h)

Article
03/29/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 fichier.

[in, optional] NewFileSize

Pointeur vers une variable qui spécifie la taille en octets à 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 le fichier entier peut être tronqué.

Valeur retournée

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

Remarques

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

Un fichier ne peut pas être tronqué (et MmCanFileBeTruncated retourne FALSE) si l’une des conditions 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 de données pour le fichier, et NewFileSize<= la taille de fichier actuelle.