структура LOOKUP_STREAM_FROM_CLUSTER_ENTRY (winioctl.h)

  • Статья

Возвращается из кода элемента управления FSCTL_LOOKUP_STREAM_FROM_CLUSTER . Ноль или несколько этих структур соответствуют структуре LOOKUP_STREAM_FROM_CLUSTER_OUTPUT в возвращаемом буфере вывода.

Синтаксис

typedef struct _LOOKUP_STREAM_FROM_CLUSTER_ENTRY {
  DWORD         OffsetToNext;
  DWORD         Flags;
  LARGE_INTEGER Reserved;
  LARGE_INTEGER Cluster;
  WCHAR         FileName[1];
} LOOKUP_STREAM_FROM_CLUSTER_ENTRY, *PLOOKUP_STREAM_FROM_CLUSTER_ENTRY;

Члены

OffsetToNext

Смещение в байтах от начала этой структуры до следующей возвращаемой структуры LOOKUP_STREAM_FROM_CLUSTER_ENTRY . Если записей больше нет, это значение равно нулю.

Flags

Флаги, описывающие характеристики этого потока. Значение будет состоять из одного или нескольких из этих значений. Будет задано по крайней мере одно из значений LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_* , которые относятся к LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_MASK (0xff000000); Может быть задано одно или несколько других значений флага.

Значение Значение
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_PAGE_FILE
0x00000001
 Поток является частью системного файла подкачки.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_DENY_DEFRAG_SET
0x00000002
 Поток заблокирован от дефрагментации. Элемент HandleInfo [MARK_HANDLE_INFO structure](ns-winioctl-mark_handle_info.md) для этого потока имеет флаг MARK_HANDLE_PROTECT_CLUSTERS .
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_FS_SYSTEM_FILE
0x00000004
 Поток является частью файла, который является внутренним для файловой системы.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_TXF_SYSTEM_FILE
0x00000008
 Поток является частью файла, который является внутренним для TxF.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA
0x01000000
 Поток является частью атрибута $DATA для файла (потока данных).
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_INDEX
0x02000000
 Поток является частью атрибута $INDEX_ALLOCATION для файла.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_SYSTEM
0x03000000
 Поток является частью другого атрибута для файла.

Reserved

Это значение зарезервировано и в настоящее время равно нулю.

Cluster

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

FileName[1]

Строка Юникода с завершением NULL, содержащая путь к объекту относительно корня тома. Эта строка будет ссылаться на атрибут или поток, представленный кластером. Эта строка не ограничена MAX_PATH и может содержать до 32 768 символов (65 536 байт) в длину. Не все возвращенные имена файлов можно открыть; некоторые из них являются внутренними для NTFS и всегда открываются исключительно. Возвращаемая строка содержит полный путь, включая имя файла, имя потока и имя типа атрибута в форме "полный\путь\к\имени файла.ext\:streamname:typename".

Комментарии

Имя в элементе FileName может быть очень длинным и в формате, не распознаваемом клиентом, с именем потока и именем типа атрибута после имени файла. Хотя в целях диагностики рекомендуется записывать в журнал все имя файла, если оно должно быть представлено конечному пользователю, оно должно быть переформатировано для более понятного (например, удалите имя типа атрибута, а если у элемента Flags есть флаги , отличные от LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA то должно отобразиться соответствующее сообщение.

Требования

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

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

FSCTL_LOOKUP_STREAM_FROM_CLUSTER

LOOKUP_STREAM_FROM_CLUSTER_OUTPUT

Структуры управления томами