通过

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_MASK (0xff000000) 内的LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_* 值;可以设置一个或多个其他标志值。

值 含义
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_PAGE_FILE
0x00000001
 流是系统页面文件的一部分。
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_DENY_DEFRAG_SET
0x00000002
 流被锁定，无法进行碎片整理。 此流的 [MARK_HANDLE_INFO 结构] (ns-winioctl-mark_handle_info.md) 的 HandleInfo 成员具有 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 结尾的 Unicode 字符串，包含相对于卷根目录的对象路径。 此字符串将引用群集表示的属性或流。 此字符串不受 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

卷管理结构