estructura LOOKUP_STREAM_FROM_CLUSTER_ENTRY (winioctl.h)

  • Artículo

Se devuelve desde el código de control FSCTL_LOOKUP_STREAM_FROM_CLUSTER. Cero o más de estas estructuras siguen la estructura LOOKUP_STREAM_FROM_CLUSTER_OUTPUT en el búfer de salida devuelto.

Sintaxis

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;

Miembros

OffsetToNext

Desplazamiento en bytes desde el principio de esta estructura hasta el siguiente LOOKUP_STREAM_FROM_CLUSTER_ENTRY estructura devuelta. Si no hay más entradas, este valor es cero.

Flags

Marcas que describen las características de esta secuencia. El valor constará de uno o varios de estos valores. Se establecerá al menos uno de los valores LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_* que se encuentran dentro del LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_MASK (0xff000000); Se pueden establecer uno o varios de los otros valores de marca.

Valor Significado
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_PAGE_FILE
0x00000001
 La secuencia forma parte del archivo de página del sistema.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_DENY_DEFRAG_SET
0x00000002
 La secuencia está bloqueada desde la desfragmentación. El miembro HandleInfo de la [estructura MARK_HANDLE_INFO](ns-winioctl-mark_handle_info.md) de esta secuencia tiene establecida la marca MARK_HANDLE_PROTECT_CLUSTERS .
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_FS_SYSTEM_FILE
0x00000004
 La secuencia forma parte de un archivo que es interno al sistema de archivos.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_FLAG_TXF_SYSTEM_FILE
0x00000008
 La secuencia forma parte de un archivo que es interno a TxF.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA
0x01000000
 La secuencia forma parte de un atributo $DATA para el archivo (flujo de datos).
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_INDEX
0x02000000
 La secuencia forma parte del atributo $INDEX_ALLOCATION para el archivo.
LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_SYSTEM
0x03000000
 La secuencia forma parte de otro atributo para el archivo.

Reserved

Este valor está reservado y actualmente es cero.

Cluster

Este es el clúster al que hace referencia esta entrada. Será uno de los clústeres pasados en la estructura de entrada.

FileName[1]

Cadena Unicode terminada en NULL que contiene la ruta de acceso del objeto en relación con la raíz del volumen. Esta cadena hará referencia al atributo o secuencia representado por el clúster. Esta cadena no está limitada por MAX_PATH y puede tener hasta 32 768 caracteres (65 536 bytes) de longitud. No se pueden abrir todos los nombres de archivo devueltos; algunos son internos de NTFS y siempre abiertos exclusivamente. La cadena devuelta incluye la ruta de acceso completa, incluido el nombre de archivo, el nombre de la secuencia y el nombre del tipo de atributo con el formato "ruta de acceso\completa\al\nombre de archivo.ext\:streamname:typename".

Comentarios

El nombre del miembro FileName puede ser muy largo y en un formato no reconocido por un cliente con el nombre de secuencia y el nombre del tipo de atributo después del nombre de archivo. Aunque es adecuado registrar todo el nombre de archivo con fines de diagnóstico, si se va a presentar a un usuario final, se debe volver a formatear para que sea más comprensible (por ejemplo, quite el nombre del tipo de atributo y si el miembro Flags tiene una marca distinta de LOOKUP_STREAM_FROM_CLUSTER_ENTRY_ATTRIBUTE_DATA establecer, se debe mostrar un mensaje adecuado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluye Windows.h)

Consulte también

FSCTL_LOOKUP_STREAM_FROM_CLUSTER

LOOKUP_STREAM_FROM_CLUSTER_OUTPUT

Estructuras de administración de volúmenes