struttura LOOKUP_STREAM_FROM_CLUSTER_ENTRY (winioctl.h)

Articolo
03/04/2024

Restituito dal codice di controllo FSCTL_LOOKUP_STREAM_FROM_CLUSTER . Zero o più di queste strutture seguono la struttura LOOKUP_STREAM_FROM_CLUSTER_OUTPUT nel buffer di output restituito.

Sintassi

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;

Members

OffsetToNext

Offset in byte dall'inizio di questa struttura alla struttura LOOKUP_STREAM_FROM_CLUSTER_ENTRY successiva restituita. Se non sono presenti più voci, questo valore è zero.

Flags

Flag che descrivono le caratteristiche di questo flusso. Il valore sarà costituito da uno o più di questi valori. Verranno impostati almeno uno dei valori LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_* che rientrano nel LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_MASK (0xff000000); è possibile impostare uno o più valori di flag.

Valore	Significato
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_PAGE_FILE 0x00000001	Il flusso fa parte del file di paging di sistema.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_DENY_DEFRAG_SET 0x00000002	Il flusso è bloccato dalla deframmentazione. Il membro HandleInfo della [struttura MARK_HANDLE_INFO](ns-winioctl-mark_handle_info.md) per questo flusso ha il flag MARK_HANDLE_PROTECT_CLUSTERS impostato.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_FS_SYSTEM_FILE 0x00000004	Il flusso fa parte di un file interno al file system.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_TXF_SYSTEM_FILE 0x00000008	Il flusso fa parte di un file interno a TxF.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA 0x01000000	Il flusso fa parte di un attributo $DATA per il file (flusso di dati).
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_INDEX 0x02000000	Il flusso fa parte dell'attributo $INDEX_ALLOCATION per il file.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_SYSTEM 0x03000000	Il flusso fa parte di un altro attributo per il file.

Reserved

Questo valore è riservato e attualmente è zero.

Cluster

Si tratta del cluster a cui fa riferimento questa voce. Sarà uno dei cluster passati nella struttura di input.

FileName[1]

Stringa Unicode con terminazione NULL contenente il percorso dell'oggetto rispetto alla radice del volume. Questa stringa farà riferimento all'attributo o al flusso rappresentato dal cluster. Questa stringa non è limitata da MAX_PATH e può contenere fino a 32.768 caratteri (65.536 byte). Non tutti i nomi file restituiti possono essere aperti; alcuni sono interni a NTFS e sempre aperti esclusivamente. La stringa restituita include il percorso completo, tra cui nome file, nome del flusso e nome del tipo di attributo nel formato "percorso\completo\del\file\filename.ext:streamname:typename".

Commenti

Il nome nel membro FileName può essere molto lungo e in un formato non riconosciuto da un cliente con il nome del flusso e il nome del tipo di attributo seguendo il nome del nome file. Anche se è appropriato registrare l'intero nome file a scopo diagnostico, se deve essere presentato a un utente finale, deve essere riformattato per essere più comprensibile( ad esempio, rimuovere il nome del tipo di attributo e se il membro Flags ha un flag diverso da LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA impostato, deve essere visualizzato un messaggio appropriato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	winioctl.h (include Windows.h)

Vedi anche

FSCTL_LOOKUP_STREAM_FROM_CLUSTER

LOOKUP_STREAM_FROM_CLUSTER_OUTPUT

Strutture di gestione dei volumi

Share via