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 |