estructura FILE_BASIC_INFORMATION (wdm.h)

Artículo
08/08/2023

La estructura FILE_BASIC_INFORMATION contiene marcas de tiempo y atributos básicos de un archivo. Se usa como argumento para rutinas que consultan o establecen información de archivo.

Sintaxis

typedef struct _FILE_BASIC_INFORMATION {
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  ULONG         FileAttributes;
} FILE_BASIC_INFORMATION, *PFILE_BASIC_INFORMATION;

Miembros

CreationTime

Especifica la hora en que se creó el archivo.

LastAccessTime

Especifica la hora a la que se obtuvo acceso por última vez al archivo.

LastWriteTime

Especifica la hora en la que se escribió por última vez el archivo.

ChangeTime

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

FileAttributes

Especifica una o varias marcas FILE_ATTRIBUTE_XXX . Para obtener descripciones de estas marcas, vea Constantes de atributo de archivo en el Microsoft Windows SDK.

Comentarios

La marca FILE_ATTRIBUTE_NORMAL no se puede establecer ni devolver en combinación con ningún otro atributo. Todos los demás valores fileAttributes invalidan este atributo.

Los valores de hora CreationTime, LastAccessTime, LastWriteTime y ChangeTime se expresan en formato de hora del sistema absoluto. La hora absoluta del sistema es el número de intervalos de 100 nanosegundos desde el inicio del año 1601 en el calendario gregoriano.

Si especifica un valor de cero para cualquiera de los miembros XxxTime de la estructura FILE_BASIC_INFORMATION , la función ZwSetInformationFile mantiene la configuración actual de un archivo durante ese tiempo.

El sistema de archivos actualiza los valores de los miembros LastAccessTime, LastWriteTime y ChangeTime según corresponda después de realizar una operación de E/S en un archivo. Un controlador o aplicación puede solicitar que el sistema de archivos no actualice uno o varios de estos miembros para las operaciones de E/S que se realizan en el identificador de archivo del autor de la llamada estableciendo los miembros adecuados en -1. El autor de la llamada puede establecer una, todas o cualquier otra combinación de estos tres miembros en -1. Solo los miembros establecidos en -1 no se verán afectados por las operaciones de E/S en el identificador de archivo; los demás miembros se actualizarán según corresponda. En los sistemas NTFS y ReFS, las actualizaciones de marca de tiempo en el identificador de archivo se pueden restaurar estableciendo los miembros adecuados en -2.

Para establecer los miembros de esta estructura, el autor de la llamada debe tener FILE_WRITE_ATTRIBUTES acceso al archivo.