struktur LOOKUP_STREAM_FROM_CLUSTER_ENTRY (winioctl.h)

Artikel
03/13/2024

Dikembalikan dari kode kontrol FSCTL_LOOKUP_STREAM_FROM_CLUSTER . Nol atau lebih struktur ini mengikuti struktur LOOKUP_STREAM_FROM_CLUSTER_OUTPUT dalam buffer output yang dikembalikan.

Sintaks

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;

Anggota

OffsetToNext

Offset dalam byte dari awal struktur ini ke struktur LOOKUP_STREAM_FROM_CLUSTER_ENTRY berikutnya dikembalikan. Jika tidak ada entri lagi, nilai ini adalah nol.

Flags

Bendera yang menjelaskan karakteristik tentang aliran ini. Nilai akan terdiri dari satu atau beberapa nilai ini. Setidaknya salah satu nilai LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_* yang termasuk dalam LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_MASK (0xff000000) akan ditetapkan; satu atau beberapa nilai bendera lainnya dapat diatur.

Nilai	Makna
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_PAGE_FILE 0x00000001	Aliran adalah bagian dari pagefile sistem.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_DENY_DEFRAG_SET 0x00000002	Aliran dikunci dari defragmentasi. Anggota HandleInfo dari [struktur MARK_HANDLE_INFO](ns-winioctl-mark_handle_info.md) untuk aliran ini memiliki bendera MARK_HANDLE_PROTECT_CLUSTERS yang ditetapkan.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_FS_SYSTEM_FILE 0x00000004	Aliran adalah bagian dari file yang bersifat internal untuk sistem file.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_TXF_SYSTEM_FILE 0x00000008	Aliran adalah bagian dari file yang internal untuk TxF.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA 0x01000000	Aliran adalah bagian dari atribut $DATA untuk file (aliran data).
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_INDEX 0x02000000	Aliran adalah bagian dari atribut $INDEX_ALLOCATION untuk file.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_SYSTEM 0x03000000	Aliran adalah bagian dari atribut lain untuk file.

Reserved

Nilai ini dicadangkan dan saat ini nol.

Cluster

Ini adalah kluster yang dirujuk oleh entri ini. Ini akan menjadi salah satu kluster yang diteruskan dalam struktur input.

FileName[1]

String Unicode yang dihentikan NULL yang berisi jalur objek relatif terhadap akar volume. String ini akan merujuk ke atribut atau aliran yang diwakili oleh kluster. String ini tidak dibatasi oleh MAX_PATH dan mungkin memiliki panjang hingga 32.768 karakter (65.536 byte). Tidak semua nama file yang dikembalikan dapat dibuka; beberapa bersifat internal untuk NTFS dan selalu dibuka secara eksklusif. String yang dikembalikan mencakup jalur lengkap termasuk nama file, nama aliran, dan nama jenis atribut dalam formulir "jalur\lengkap\ke\file filename.ext\:streamname:typename".

Keterangan

Nama di anggota FileName bisa sangat panjang dan dalam format yang tidak dikenali oleh pelanggan dengan nama aliran dan nama jenis atribut mengikuti nama file. Meskipun sesuai untuk mencatat seluruh nama file untuk tujuan diagnostik, jika harus disajikan kepada pengguna akhir, harus diformat ulang agar lebih mudah dipahami (misalnya, hapus nama jenis atribut dan jika anggota Bendera memiliki bendera selain LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA diatur maka pesan yang sesuai harus ditampilkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Header	winioctl.h (termasuk Windows.h)

Lihat juga

FSCTL_LOOKUP_STREAM_FROM_CLUSTER

LOOKUP_STREAM_FROM_CLUSTER_OUTPUT

Struktur Manajemen Volume

Bagikan melalui