структура FILE_NOTIFY_EXTENDED_INFORMATION (winnt.h)

  • Статья

Описывает изменения, обнаруженные функцией ReadDirectoryChangesExW .

Синтаксис

typedef struct _FILE_NOTIFY_EXTENDED_INFORMATION {
  DWORD         NextEntryOffset;
  DWORD         Action;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastModificationTime;
  LARGE_INTEGER LastChangeTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER AllocatedLength;
  LARGE_INTEGER FileSize;
  DWORD         FileAttributes;
  union {
    DWORD ReparsePointTag;
    DWORD EaSize;
  } DUMMYUNIONNAME;
  LARGE_INTEGER FileId;
  LARGE_INTEGER ParentFileId;
  DWORD         FileNameLength;
  WCHAR         FileName[1];
} FILE_NOTIFY_EXTENDED_INFORMATION, *PFILE_NOTIFY_EXTENDED_INFORMATION;

Члены

NextEntryOffset

Число байтов, которое необходимо пропустить, чтобы перейти к следующей записи. Нулевое значение указывает, что это последняя запись.

Action

Тип произошедшего изменения. Этот элемент может иметь одно из следующих значений.

Значение Значение
FILE_ACTION_ADDED
0x00000001
 Файл был добавлен в каталог .
FILE_ACTION_REMOVED
0x00000002
 Файл был удален из каталога.
FILE_ACTION_MODIFIED
0x00000003
 Файл был изменен. Это может быть изменение метки времени или атрибутов.
FILE_ACTION_RENAMED_OLD_NAME
0x00000004
 Файл был переименован, и это старое имя.
FILE_ACTION_RENAMED_NEW_NAME
0x00000005
 Файл был переименован, и это новое имя.

CreationTime

Дата и время создания каталога или файла и их добавления в файловую систему.

LastModificationTime

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

LastChangeTime

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

LastAccessTime

Дата и время последнего доступа к каталогу или файлу в файловой системе.

AllocatedLength

Выделенный размер файла в байтах.

FileSize

Новый размер каталога или файла в байтах или старый размер, если размер не изменился.

FileAttributes

Атрибуты каталога или файла.

DUMMYUNIONNAME

DUMMYUNIONNAME.ReparsePointTag

DUMMYUNIONNAME.EaSize

FileId

Идентификатор каталога или файла.

ParentFileId

Идентификатор родительского каталога для файла.

FileNameLength

Размер части записи с именем файла в байтах. Это значение не включает завершающий символ NULL.

FileName[1]

Поле переменной длины, содержащее имя файла относительно дескриптора каталога. Имя файла имеет символьный формат Юникода и не заканчивается null.

Если файл имеет короткое и длинное имя, функция вернет одно из этих имен, но оно не указано.

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1709 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Верхняя часть winnt.h (включая Windows.h)

См. также раздел

ReadDirectoryChangesExW