Estrutura FILETIME (minwinbase.h)

Contém um valor de 64 bits que representa o número de intervalos de 100 nanossegundos desde 1º de janeiro de 1601 (UTC).

Sintaxe

typedef struct _FILETIME {
  DWORD dwLowDateTime;
  DWORD dwHighDateTime;
} FILETIME, *PFILETIME, *LPFILETIME;

Membros

dwLowDateTime

A parte de baixa ordem do tempo do arquivo.

dwHighDateTime

A parte de alta ordem do tempo do arquivo.

Comentários

Para converter uma estrutura FILETIME em um horário fácil de exibir para um usuário, use a função FileTimeToSystemTime .

Não é recomendável adicionar e subtrair valores da estrutura FILETIME para obter tempos relativos. Em vez disso, você deve copiar as partes de baixa e alta ordem do tempo do arquivo para uma estrutura ULARGE_INTEGER , executar aritmética de 64 bits no membro QuadPart e copiar os membros LowPart e HighPart para a estrutura FILETIME .

Não converta um ponteiro para uma estrutura FILETIME em um valor ULARGE_INTEGER* ou __int64* porque ele pode causar falhas de alinhamento no Windows de 64 bits.

Nem todos os sistemas de arquivos podem registrar a criação e a hora do último acesso e nem todos os sistemas de arquivos os registram da mesma maneira. Por exemplo, no NT 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). No NTFS, a hora de acesso tem uma resolução de 1 hora. Portanto, a função GetFileTime pode não retornar as mesmas informações de tempo de arquivo definidas usando a função SetFileTime . Além disso, o FAT registra os tempos no disco no horário local. No entanto, o NTFS registra tempos em disco em UTC. Para obter mais informações, confira Horas de arquivo.

Uma função que usa a estrutura FILETIME pode permitir valores fora de zero ou valores positivos normalmente especificados pelos membros dwLowDateTime e dwHighDateTime . Por exemplo, a função SetFileTime usa 0xFFFFFFFF para especificar que o tempo de acesso anterior de um arquivo deve ser preservado. Para obter mais informações, consulte o tópico para a função que você está chamando.

Exemplos

Para obter um exemplo, consulte Alterando uma hora do arquivo para a hora atual ou Recuperando a hora do Last-Write.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho	minwinbase.h (inclua Windows.h)

Confira também

CompareFileTime

Tempos de arquivo

FileTimeToSystemTime

GetFileTime

ULARGE_INTEGER