LOOKUP_STREAM_FROM_CLUSTER_ENTRY-Struktur (winioctl.h)

Artikel
03/04/2024

Wird vom Steuerungscode FSCTL_LOOKUP_STREAM_FROM_CLUSTER zurückgegeben. Mindestens null dieser Strukturen folgen der LOOKUP_STREAM_FROM_CLUSTER_OUTPUT-Struktur im zurückgegebenen Ausgabepuffer.

Syntax

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;

Member

OffsetToNext

Offset in Bytes vom Anfang dieser Struktur bis zum nächsten LOOKUP_STREAM_FROM_CLUSTER_ENTRY zurückgegebenen Struktur. Wenn keine weiteren Einträge vorhanden sind, ist dieser Wert 0.

Flags

Flags, die Merkmale dieses Datenstroms beschreiben. Der Wert besteht aus mindestens einem dieser Werte. Mindestens einer der LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_* -Werte, die innerhalb der LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_MASK (0xff000000) liegen, wird festgelegt. mindestens einer der anderen Flagwerte kann festgelegt werden.

Wert	Bedeutung
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_PAGE_FILE 0x00000001	Der Stream ist Teil der Systemseitendatei.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_DENY_DEFRAG_SET 0x00000002	Der Stream ist für die Defragmentierung gesperrt. Das HandleInfo-Element der [MARK_HANDLE_INFO-Struktur](ns-winioctl-mark_handle_info.md) für diesen Stream hat das MARK_HANDLE_PROTECT_CLUSTERS-Flag festgelegt.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_FS_SYSTEM_FILE 0x00000004	Der Stream ist Teil einer Datei, die intern im Dateisystem ist.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_TXF_SYSTEM_FILE 0x00000008	Der Stream ist Teil einer TxF-internen Datei.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA 0x01000000	Der Stream ist Teil eines $DATA-Attributs für die Datei (Datenstrom).
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_INDEX 0x02000000	Der Stream ist Teil des attributs $INDEX_ALLOCATION für die Datei.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_SYSTEM 0x03000000	Der Stream ist Teil eines anderen Attributs für die Datei.

Reserved

Dieser Wert ist reserviert und ist derzeit 0.

Cluster

Dies ist der Cluster, auf den sich dieser Eintrag bezieht. Es wird einer der Cluster sein, die in der Eingabestruktur übergeben werden.

FileName[1]

Eine MIT NULL beendete Unicode-Zeichenfolge, die den Pfad des Objekts relativ zum Stamm des Volumes enthält. Diese Zeichenfolge verweist auf das Attribut oder den Stream, das vom Cluster dargestellt wird. Diese Zeichenfolge ist nicht durch MAX_PATH beschränkt und kann bis zu 32.768 Zeichen (65.536 Bytes) lang sein. Nicht alle zurückgegebenen Dateinamen können geöffnet werden. einige sind intern in NTFS und immer ausschließlich geöffnet. Die zurückgegebene Zeichenfolge enthält den vollständigen Pfad, einschließlich Dateiname, Streamname und Attributtypnamen in der Form "vollständiger\Pfad\zur\Datei\dateiname.ext:streamname:typename".

Hinweise

Der Name im FileName-Element kann sehr lang und in einem Format sein, das von einem Kunden nicht erkannt wird, wobei der Streamname und der Attributtypname dem Dateinamen folgen. Es ist zwar angebracht, den gesamten Dateinamen zu Diagnosezwecken zu protokollieren, aber wenn er einem Endbenutzer angezeigt werden soll, sollte er neu formatiert werden, um verständlicher zu sein (z. B. entfernen Sie den Namen des Attributtyps, und wenn das Flags-Element ein anderes Flag als LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA festgelegt hat, sollte eine entsprechende Meldung angezeigt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile	winioctl.h (einschließlich Windows.h)

Weitere Informationen

FSCTL_LOOKUP_STREAM_FROM_CLUSTER

LOOKUP_STREAM_FROM_CLUSTER_OUTPUT

Volumeverwaltungsstrukturen

Freigeben über