estructura FILE_STAT_BASIC_INFORMATION (ntifs.h)

FILE_STAT_BASIC_INFORMATION contiene metadatos básicos sobre un archivo.

Sintaxis

typedef struct _FILE_STAT_BASIC_INFORMATION {
  LARGE_INTEGER FileId;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER AllocationSize;
  LARGE_INTEGER EndOfFile;
  ULONG         FileAttributes;
  ULONG         ReparseTag;
  ULONG         NumberOfLinks;
  ULONG         DeviceType;
  ULONG         DeviceCharacteristics;
  ULONG         Reserved;
  LARGE_INTEGER VolumeSerialNumber;
  FILE_ID_128   FileId128;
} FILE_STAT_BASIC_INFORMATION, *PFILE_STAT_BASIC_INFORMATION;

Miembros

FileId

Especifica el identificador de un archivo.

CreationTime

Especifica la hora de creación de un archivo.

LastAccessTime

Especifica la última vez que se ha accedido a un archivo.

LastWriteTime

Especifica la última vez que se escribió un archivo.

ChangeTime

Especifica la última vez que se cambió un archivo.

AllocationSize

Tamaño de asignación de archivos, en bytes. Normalmente, este valor es un múltiplo del tamaño del sector o clúster del dispositivo físico subyacente.

EndOfFile

Posición absoluta del final del archivo como desplazamiento de bytes desde el inicio del archivo. EndOfFile especifica el desplazamiento de bytes al final del archivo. Dado que este valor se basa en cero, realmente hace referencia al primer byte libre del archivo. En otras palabras, EndOfFile es el desplazamiento al byte inmediatamente después del último byte válido del archivo.

FileAttributes

Atributos de archivo, que pueden ser cualquier combinación válida de lo siguiente:

Atributo	Value
FILE_ATTRIBUTE_READONLY	0x00000001
FILE_ATTRIBUTE_HIDDEN	0x00000002
FILE_ATTRIBUTE_SYSTEM	0x00000004
FILE_ATTRIBUTE_DIRECTORY	0x00000010
FILE_ATTRIBUTE_ARCHIVE	0x00000020
FILE_ATTRIBUTE_NORMAL	0x00000080

ReparseTag

Etiqueta de punto de reanálisis. Consulte Acerca de los puntos de reanálisis para obtener más información.

NumberOfLinks

Especifica el número de vínculos al archivo.

DeviceType

Se establece cuando un controlador llama a IoCreateDevice según corresponda para el tipo de dispositivo subyacente. Para obtener más información, vea Especificar tipos de dispositivo.

DeviceCharacteristics

Características del dispositivo. Para obtener una descripción de los valores pertinentes, consulte DEVICE_OBJECT.

Reserved

Reservado para uso del sistema.

VolumeSerialNumber

Número de serie del volumen donde se encuentra el archivo.

FileId128

Número de referencia del archivo de 128 bytes para el archivo. El sistema de archivos genera y asigna este número al archivo.

Comentarios

Esta información se puede consultar de cualquiera de las maneras siguientes:

• Llame a ZwQueryDirectoryFile, pasando FileStatBasicInformation como valor de FileInformationClass y pasando un búfer asignado por el autor de la llamada, FILE_ID_EXTD_DIR_INFORMATION estructurado como el valor de FileInformation.

• Create un IRP con IRP_MJ_DIRECTORY_CONTROL de código de función principal y IRP_MN_QUERY_DIRECTORY de código de función secundaria.

No se requieren derechos de acceso específicos para consultar esta información.

Se garantiza que los números de referencia de archivo, también denominados identificadores de archivo, son únicos solo dentro de un sistema de archivos estático. No se garantiza que sean únicos a lo largo del tiempo, ya que los sistemas de archivos son libres de reutilizarlos. Tampoco se garantiza que permanezcan constantes. Por ejemplo, el sistema de archivos FAT genera el número de referencia de archivo para un archivo a partir del desplazamiento de bytes del registro de entrada de directorio (DIRENT) del archivo en el disco. La desfragmentación puede cambiar este desplazamiento de bytes. Por lo tanto, un número de referencia de archivo FAT puede cambiar con el tiempo.

Todas las fechas y horas están en formato absoluto de tiempo del sistema. La hora absoluta del sistema es el número de intervalos de 100 nanosegundos desde el inicio del año 1601.

Esta estructura debe alinearse en un límite de LONGLONG (8 bytes). Si un búfer contiene dos o más de estas estructuras, el valor NextEntryOffset de cada entrada, excepto el último, cae en un límite de 8 bytes.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 11, versión 24H2
Encabezado	ntifs.h

Consulte también

FILE_INFORMATION_CLASS

**ZwQueryInformationByName **