LOOKUP_STREAM_FROM_CLUSTER_ENTRY構造体 (winioctl.h)

  • [アーティクル]

FSCTL_LOOKUP_STREAM_FROM_CLUSTER 制御コードから返されます。 これらの構造体の 0 個以上は、返される出力バッファー内の 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 構造体へのオフセット (バイト単位)。 これ以上エントリがない場合、この値は 0 です。

Flags

このストリームに関する特性を記述するフラグ。 値は、これらの値の 1 つ以上で構成されます。 LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_MASK (0xff000000) 内にある少なくとも 1 つのLOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_* 値が設定されます。1つ以上の他のフラグ値が設定され得る。

値 意味
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

この値は予約済みであり、現在は 0 です。

Cluster

これは、このエントリが参照するクラスターです。 これは、入力構造で渡されるクラスターの 1 つになります。

FileName[1]

ボリュームのルートに対する相対オブジェクトのパスを含む NULL で終わる Unicode 文字列。 この文字列は、クラスターによって表される属性またはストリームを参照します。 この文字列は 、MAX_PATH によって制限されず、最大 32,768 文字 (65,536 バイト) の長さにできます。 返されたすべてのファイル名を開くことができるわけではありません。一部は NTFS の内部であり、常に排他的に開かれます。 返される文字列には、ファイル名、ストリーム名、属性の型名を含む完全なパスが含まれます。"file\filename.ext:streamname:typenameへの\完全な\パス\" という形式です。

注釈

FileName メンバーの名前は非常に長く、ファイル名の後にストリーム名と属性の種類名を持つ顧客が認識しない形式にすることができます。 診断目的でファイル名全体をログに記録するのが適切ですが、エンドユーザーに表示される場合は、より理解しやすくするために再フォーマットする必要があります (たとえば、属性の種類名を削除し、 Flags メンバー に LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA 以外のフラグが 設定されている場合は、適切なメッセージを表示する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
Header winioctl.h (Windows.h を含む)

こちらもご覧ください

FSCTL_LOOKUP_STREAM_FROM_CLUSTER

LOOKUP_STREAM_FROM_CLUSTER_OUTPUT

ボリューム管理の構造体