структура FILE_BASIC_INFORMATION (wdm.h)
Структура 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 доступ к файлу.
Требования
Требование | Ценность |
---|---|
заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |