Funzione MmCanFileBeTruncated (ntifs.h)

Articolo
12/21/2024

La routine MmCanFileBeTruncated controlla 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 che contiene i puntatori agli oggetti sezione dell'oggetto file.

[in, optional] NewFileSize

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

Valore restituito

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

Osservazioni

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

Un file non può essere troncato (e MmCanFileBeTruncated restituirà FALSE) se uno dei seguenti è true:

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