Función MmCanFileBeTruncated (ntifs.h)

Artículo
03/29/2024

La rutina MmCanFileBeTruncated comprueba si se puede truncar un archivo.

Sintaxis

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

Parámetros

[in] SectionPointer

Puntero a una estructura que contiene los punteros de objeto de sección del objeto de archivo.

[in, optional] NewFileSize

Puntero a una variable que especifica el tamaño en bytes al que se va a truncar el archivo. Si este parámetro es NULL, se supone una longitud de cero y MmCanFileBeTruncated comprueba si se puede truncar todo el archivo.

Valor devuelto

MmCanFileBeTruncated devuelve TRUE si se puede truncar el archivo; FALSE en caso contrario.

Comentarios

Se debe llamar siempre a MmCanFileBeTruncated antes de que se trunque un archivo.

No se puede truncar un archivo (y MmCanFileBeTruncated devolverá FALSE) si se cumple alguna de las siguientes condiciones:

Existe una sección de imagen para el archivo.
Hay uno o varios sondeos de escritura pendientes en la sección de datos del archivo.
Hay una vista asignada de la sección de datos del archivo dentro del intervalo de truncamiento determinado por NewFileSize.
Uno o varios usuarios contienen referencias a la sección de datos del archivo y NewFileSize<= el tamaño de archivo actual.