Función GetFileTime (fileapi.h)

Artículo
08/23/2023

Recupera la fecha y hora en que se crearon un archivo o directorio, así como la última vez que se accedió a ellos o se modificaron.

Sintaxis

BOOL GetFileTime(
  [in]            HANDLE     hFile,
  [out, optional] LPFILETIME lpCreationTime,
  [out, optional] LPFILETIME lpLastAccessTime,
  [out, optional] LPFILETIME lpLastWriteTime
);

Parámetros

[in] hFile

Identificador del archivo o directorio para el que se van a recuperar fechas y horas. El identificador debe haberse creado con la función CreateFile con el derecho de acceso GENERIC_READ . Para obtener más información, vea Seguridad de archivos y derechos de acceso.

[out, optional] lpCreationTime

Puntero a una estructura FILETIME para recibir la fecha y hora en que se creó el archivo o directorio. Este parámetro puede ser NULL si la aplicación no requiere esta información.

[out, optional] lpLastAccessTime

Puntero a una estructura FILETIME para recibir la fecha y hora en que se accedió por última vez al archivo o directorio. La última hora de acceso incluye la última vez que se escribió el archivo o directorio en, leer desde o, en el caso de los archivos ejecutables, ejecutar. Este parámetro puede ser NULL si la aplicación no requiere esta información.

[out, optional] lpLastWriteTime

Puntero a una estructura FILETIME para recibir la fecha y hora en que el archivo o directorio se escribió por última vez en, truncado o sobrescrito (por ejemplo, con WriteFile o SetEndOfFile). Esta fecha y hora no se actualizan cuando se cambian los atributos de archivo o los descriptores de seguridad. Este parámetro puede ser NULL si la aplicación no requiere esta información.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

No todos los sistemas de archivos pueden registrar los tiempos de creación y última hora de acceso y no todos los sistemas de archivos los registran de la misma manera. Por ejemplo, en FAT, el tiempo de creación tiene una resolución de 10 milisegundos, el tiempo de escritura tiene una resolución de 2 segundos y el tiempo de acceso tiene una resolución de 1 día (realmente, la fecha de acceso). Por lo tanto, es posible que la función GetFileTime no devuelva la misma información de tiempo de archivo establecida mediante la función SetFileTime .

NTFS retrasa las actualizaciones de la última hora de acceso de un archivo hasta una hora después del último acceso. NTFS también permite deshabilitar las actualizaciones de la hora de último acceso. La hora de último acceso no se actualiza en volúmenes NTFS de forma predeterminada.

Windows Server 2003 y Windows XP: La hora de último acceso se actualiza en volúmenes NTFS de forma predeterminada.

Para más información, consulte Tiempos de archivo.

Si cambia el nombre o elimina un archivo, restáurelo poco después, Windows busca en la memoria caché la información del archivo que se va a restaurar. La información almacenada en caché incluye su par de nombres cortos y largos y el tiempo de creación.

Ejemplos

Para obtener un ejemplo, consulte Recuperación de la hora de Last-Write.

Requisitos


Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	fileapi.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll