Função GetFileTime (fileapi.h)
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 |