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

Статья
02/29/2024

Структура 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. Описание этих флагов см. в разделе File Attribute Constants в Microsoft Windows SDK.

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

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

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

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