структура FILE_BASIC_INFORMATION (wdm.h)

Статья
02/07/2025

Структура FILE_BASIC_INFORMATION содержит метки времени и основные атрибуты файла. Он используется в качестве аргумента для подпрограмм, которые запрашивают или задают сведения о файле.

Синтаксис

typedef struct _FILE_BASIC_INFORMATION {
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  ULONG         FileAttributes;
} FILE_BASIC_INFORMATION, *PFILE_BASIC_INFORMATION;

Члены

CreationTime

Указывает время создания файла.

LastAccessTime

Указывает время последнего доступа к файлу.

LastWriteTime

Указывает время последнего записи файла.

ChangeTime

Указывает время последнего изменения файла.

FileAttributes

Указывает один или несколько флагов FILE_ATTRIBUTE_XXX. Описание этих флагов см. в константы атрибутов файлов в пакете SDK для Microsoft Windows.

Замечания

Флаг FILE_ATTRIBUTE_NORMAL нельзя задать или вернуть в сочетании с другими атрибутами. Все остальные FileAttributes переопределяют этот атрибут.

Значения времени CreationTime, LastAccessTime, LastWriteTimeи ChangeTime выражаются в абсолютном системном формате времени. Абсолютное системное время — это число 100-наносекунд интервалов с начала года 1601 года в григорианском календаре.

Если указать значение нуля для любого из элементов XxxTime структуры FILE_BASIC_INFORMATION, функция ZwSetInformationFile сохраняет текущий параметр файла в течение этого времени.

Файловая система обновляет значения LastAccessTime, LastWriteTimeи элементы ChangeTime соответствующим образом после выполнения операции ввода-вывода в файле. Драйвер или приложение может запросить, чтобы файловая система не обновляла одного или нескольких из этих элементов для операций ввода-вывода, выполняемых на дескрипторе файла вызывающего объекта, задав соответствующим членам значение -1. Вызывающий объект может задать одно, все или любое другое сочетание этих трех элементов значение -1. Только те элементы, которые имеют значение -1, не будут затронуты операциями ввода-вывода в дескрипторе файла; Остальные члены будут обновлены соответствующим образом. В системах NTFS и ReFS обновления меток времени для дескриптора файлов можно восстановить, установив для соответствующих членов значение -2.

Чтобы задать члены этой структуры, вызывающий объект должен иметь FILE_WRITE_ATTRIBUTES доступ к файлу.