Função GetFileTime (fileapi.h)

Artigo
08/23/2023

Recupera a data e a hora em que um arquivo ou diretório foi criado, acessado pela última vez e modificado pela última vez.

Sintaxe

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

Parâmetros

[in] hFile

Um identificador para o arquivo ou diretório para o qual as datas e horas devem ser recuperadas. O identificador deve ter sido criado usando a função CreateFile com o direito de acesso GENERIC_READ . Para obter mais informações, consulte Segurança de arquivos e Direitos de Acesso.

[out, optional] lpCreationTime

Um ponteiro para uma estrutura FILETIME para receber a data e a hora em que o arquivo ou diretório foi criado. Esse parâmetro poderá ser NULL se o aplicativo não exigir essas informações.

[out, optional] lpLastAccessTime

Um ponteiro para uma estrutura FILETIME para receber a data e a hora em que o arquivo ou diretório foi acessado pela última vez. A hora do último acesso inclui a última vez em que o arquivo ou diretório foi gravado, lido ou, no caso de arquivos executáveis, executado. Esse parâmetro poderá ser NULL se o aplicativo não exigir essas informações.

[out, optional] lpLastWriteTime

Um ponteiro para uma estrutura FILETIME para receber a data e a hora em que o arquivo ou diretório foi gravado pela última vez, truncado ou substituído (por exemplo, com WriteFile ou SetEndOfFile). Essa data e hora não são atualizadas quando atributos de arquivo ou descritores de segurança são alterados. Esse parâmetro poderá ser NULL se o aplicativo não exigir essas informações.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Nem todos os sistemas de arquivos podem registrar a criação e os últimos tempos de acesso e nem todos os sistemas de arquivos os registram da mesma maneira. Por exemplo, no FAT, o tempo de criação tem uma resolução de 10 milissegundos, o tempo de gravação tem uma resolução de 2 segundos e o tempo de acesso tem uma resolução de 1 dia (na verdade, a data de acesso). Portanto, a função GetFileTime pode não retornar as mesmas informações de tempo de arquivo definidas usando a função SetFileTime .

O NTFS atrasa as atualizações para a última hora de acesso de um arquivo em até uma hora após o último acesso. O NTFS também permite que as últimas atualizações de tempo de acesso sejam desabilitadas. A hora do último acesso não é atualizada em volumes NTFS por padrão.

Windows Server 2003 e Windows XP: A hora do último acesso é atualizada em volumes NTFS por padrão.

Para obter mais informações, confira Horas de arquivo.

Se você renomear ou excluir um arquivo, restaurá-lo logo depois, o Windows pesquisará no cache informações de arquivo para restaurar. As informações armazenadas em cache incluem seu par de nomes curto/longo e tempo de criação.

Exemplos

Para obter um exemplo, consulte Recuperando o tempo de Last-Write.

Requisitos


Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	fileapi.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll