Funzione MmCanFileBeTruncated (ntifs.h)

Articolo
03/29/2024

La routine MmCanFileBeTruncated verifica se un file può essere troncato.

Sintassi

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

Parametri

[in] SectionPointer

Puntatore a una struttura contenente i puntatori a oggetti sezione dell'oggetto file.

[in, optional] NewFileSize

Puntatore a una variabile che specifica le dimensioni in byte a cui deve essere troncato il file. Se questo parametro è NULL, si presuppone una lunghezza di zero e MmCanFileBeTruncated verifica se l'intero file può essere troncato.

Valore restituito

MmCanFileBeTruncated restituisce TRUE se il file può essere troncato; FALSE in caso contrario.

Commenti

MmCanFileBeTruncated deve essere sempre chiamato prima che venga troncato un file.

Non è possibile troncare un file (e MmCanFileBeTruncated restituirà FALSE) se uno dei seguenti è true:

Esiste una sezione immagine per il file.
Nella sezione dati del file sono presenti uno o più probe di scrittura in sospeso.
Esiste una visualizzazione mappata dei dati del file all'interno dell'intervallo di troncamento determinato da NewFileSize.
Uno o più utenti contengono riferimenti alla sezione dati per il file e NewFileSize<= le dimensioni correnti del file.