Função SetFileTime (fileapi.h)

Artigo
08/23/2023

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

Sintaxe

BOOL SetFileTime(
  [in]           HANDLE         hFile,
  [in, optional] const FILETIME *lpCreationTime,
  [in, optional] const FILETIME *lpLastAccessTime,
  [in, optional] const FILETIME *lpLastWriteTime
);

Parâmetros

[in] hFile

Um identificador para o arquivo ou diretório. O identificador deve ter sido criado usando a função CreateFile com o direito de acesso FILE_WRITE_ATTRIBUTES. Para obter mais informações, consulte Segurança de arquivo e direitos de acesso.

[in, optional] lpCreationTime

Um ponteiro para uma estrutura FILETIME que contém a nova data e hora de criação para o arquivo ou diretório. Se o aplicativo não precisar alterar essas informações, defina esse parâmetro como NULL ou como um ponteiro para uma estrutura FILETIME que tenha os membros dwLowDateTime e dwHighDateTime definidos como 0.

[in, optional] lpLastAccessTime

Um ponteiro para uma estrutura FILETIME que contém a nova data e hora do último acesso para o arquivo ou diretório. 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. Se o aplicativo não precisar alterar essas informações, defina esse parâmetro como NULL ou como um ponteiro para uma estrutura FILETIME que tenha os membros dwLowDateTime e dwHighDateTime definidos como 0.

Para impedir que as operações de arquivo que usam o identificador determinado modifiquem a hora do último acesso, chame SetFileTime imediatamente após abrir o identificador de arquivo e passe uma estrutura FILETIME que tenha os membros dwLowDateTime e dwHighDateTime definidos 0xFFFFFFFFcomo .

[in, optional] lpLastWriteTime

Um ponteiro para uma estrutura FILETIME que contém a nova data e hora da última modificação para o arquivo ou diretório. Se o aplicativo não precisar alterar essas informações, defina esse parâmetro como NULL ou como um ponteiro para uma estrutura FILETIME que tenha os membros dwLowDateTime e dwHighDateTime definidos como 0.

Para impedir que as operações de arquivo que usam o identificador determinado modifiquem a hora da última gravação, chame SetFileTime imediatamente após abrir o identificador de arquivo e passe uma estrutura FILETIME que tenha os membros dwLowDateTime e dwHighDateTime definidos 0xFFFFFFFFcomo .

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 horários 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 SetFileTime. O NTFS atrasa as atualizações para a hora do último acesso de um arquivo em até uma hora após o último acesso.

Exemplos

Para obter um exemplo, consulte Alterando um tempo de arquivo para a hora atual.

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