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つ以上の他のフラグ値が設定され得る。

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 以外のフラグが 設定されている場合は、適切なメッセージを表示する必要があります。

要件

こちらもご覧ください

FSCTL_LOOKUP_STREAM_FROM_CLUSTER

LOOKUP_STREAM_FROM_CLUSTER_OUTPUT

ボリューム管理の構造体