Функция MmCanFileBeTruncated (ntifs.h)
Подпрограмма MmCanFileBeTruncated проверяет возможность усечения файла.
Синтаксис
BOOLEAN MmCanFileBeTruncated(
[in] PSECTION_OBJECT_POINTERS SectionPointer,
[in, optional] PLARGE_INTEGER NewFileSize
);
Параметры
[in] SectionPointer
Указатель на структуру, содержащую указатели на объект section объекта файла.
[in, optional] NewFileSize
Указатель на переменную, указывающую размер в байтах, до которого должен быть усечен файл. Если этот параметр имеет значение NULL, то предполагается, что длина равна нулю, и MmCanFileBeTruncated проверяет, можно ли обрезать весь файл.
Возвращаемое значение
MmCanFileBeTruncated возвращает значение TRUE, если файл может быть усечен; В противном случае — FALSE.
Комментарии
Перед усечением файла необходимо всегда вызывать MmCanFileBeTruncated.
Невозможно усечение файла (и MmCanFileBeTruncated возвращает значение FALSE), если выполняется какое-либо из следующих значений:
Для файла существует раздел изображения.
В разделе данных файла есть одна или несколько невыполненных проб записи.
Существует сопоставленное представление раздела данных файла в диапазоне усечения, определяемом newFileSize.
Один или несколько пользователей содержат ссылки на раздел данных для файла, а NewFileSize< = текущий размер файла.
Требования
Требование | Значение |
---|---|
Целевая платформа | Универсальное |
Верхняя часть | ntifs.h (включая Ntifs.h) |
Библиотека | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |