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