LOOKUP_STREAM_FROM_CLUSTER_ENTRY structure (winioctl.h)

Article
03/08/2023

Retournée à partir du code de contrôle FSCTL_LOOKUP_STREAM_FROM_CLUSTER. Une ou plusieurs de ces structures suivent la structure LOOKUP_STREAM_FROM_CLUSTER_OUTPUT dans la mémoire tampon de sortie retournée.

Syntaxe

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;

Membres

OffsetToNext

Décalage en octets du début de cette structure à la structure LOOKUP_STREAM_FROM_CLUSTER_ENTRY suivante retournée. S’il n’y a plus d’entrées, cette valeur est égale à zéro.

Flags

Indicateurs décrivant les caractéristiques de ce flux. La valeur se compose d’une ou plusieurs de ces valeurs. Au moins une des valeurs LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_* qui appartiennent à la LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_MASK (0xff000000) sera définie ; une ou plusieurs des autres valeurs d’indicateur peuvent être définies.

Valeur	Signification
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_PAGE_FILE 0x00000001	Le flux fait partie du fichier de page système.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_DENY_DEFRAG_SET 0x00000002	Le flux est verrouillé à partir de la défragmentation. L’indicateur MARK_HANDLE_PROTECT_CLUSTERS est défini pour le membre HandleInfo de la [structure MARK_HANDLE_INFO](ns-winioctl-mark_handle_info.md) de ce flux.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_FS_SYSTEM_FILE 0x00000004	Le flux fait partie d’un fichier interne au système de fichiers.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_TXF_SYSTEM_FILE 0x00000008	Le flux fait partie d’un fichier interne à TxF.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA 0x01000000	Le flux fait partie d’un attribut $DATA pour le fichier (flux de données).
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_INDEX 0x02000000	Le flux fait partie de l’attribut $INDEX_ALLOCATION pour le fichier.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_SYSTEM 0x03000000	Le flux fait partie d’un autre attribut pour le fichier.

Reserved

Cette valeur est réservée et est actuellement égale à zéro.

Cluster

Il s’agit du cluster auquel cette entrée fait référence. Il s’agit de l’un des clusters passés dans la structure d’entrée.

FileName[1]

Chaîne Unicode terminée par null contenant le chemin d’accès de l’objet par rapport à la racine du volume. Cette chaîne fait référence à l’attribut ou au flux représenté par le cluster. Cette chaîne n’est pas limitée par MAX_PATH et peut contenir jusqu’à 32 768 caractères (65 536 octets). Tous les noms de fichiers retournés ne peuvent pas être ouverts ; certains sont internes à NTFS et sont toujours ouverts exclusivement. La chaîne retournée inclut le chemin d’accès complet, y compris le nom de fichier, le nom du flux et le nom du type d’attribut sous la forme « full\path\to\file\filename.ext :streamname :typename ».

Remarques

Le nom dans le membre FileName peut être très long et dans un format non reconnu par un client avec le nom de flux et le nom de type d’attribut qui suivent le nom de fichier. Bien qu’il soit approprié d’enregistrer le nom de fichier entier à des fins de diagnostic, s’il doit être présenté à un utilisateur final, il doit être reformaté pour être plus compréhensible (par exemple, supprimez le nom du type d’attribut et si le membre Flags a un indicateur autre que LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA défini, un message approprié doit être affiché.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	winioctl.h (inclure Windows.h)

Voir aussi

FSCTL_LOOKUP_STREAM_FROM_CLUSTER

LOOKUP_STREAM_FROM_CLUSTER_OUTPUT

Structures de gestion des volumes

Partager via