Función MmCanFileBeTruncated (ntifs.h)
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.
Observaciones
mmCanFileBeTruncated debe llamarse siempre antes de que se trunca un archivo.
No se puede truncar un archivo (y MmCanFileBeTruncated devolverá FALSE) si se cumple alguno de los siguientes elementos:
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.
Requisitos
Requisito | Valor |
---|---|
de la plataforma de destino de |
Universal |
encabezado de |
ntifs.h (incluya Ntifs.h) |
biblioteca de |
NtosKrnl.lib |
DLL de |
NtosKrnl.exe |
irQL | < DISPATCH_LEVEL |
Consulte también
mmFlushImageSection de