SetFileTime

9/8/2008

Essa função define a data e tempo que um arquivo foi criado, acessado pela última vez ou modificado pela última vez. Um remoto aplicativo versão interface (RAPI) desta função é CeSetFileTime (RAPI).

Syntax

BOOL SetFileTime(
  HANDLE hFile,
  const FILETIME* lpCreationTime,
  const FILETIME* lpLastAccessTime,
  const FILETIME* lpLastWriteTime
);

Parameters

• hFile
  [no] Identificador para o arquivo para o qual definir as datas e horas.

  O identificador de arquivo deve ter sido criado com acessar GENERIC_WRITE para o arquivo.

• lpCreationTime
  [no] Ponteiro para uma estrutura FILETIME que contém a data e tempo o arquivo foi criado.

  Este parâmetro pode ser NULL se o aplicativo não precisar definir este informações.

• lpLastAccessTime
  [no] Ponteiro para um FILETIME estrutura que contém a data e tempo que o arquivo foi acessado pela última vez. A última horário do acesso inclui o último tempo o arquivo foi gravado para, ler de ou (nas maiúsculas e minúsculas dos arquivos executáveis) executar.

  Este parâmetro pode ser NULL se o aplicativo não precisar definir este informações.

• lpLastWriteTime
  [no] Ponteiro para um FILETIME estrutura que contém a data e o arquivo foi gravado pela última vez a tempo.

  Este parâmetro pode ser NULL se o aplicativo não desejar definir este informações.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Nem todos os sistemas arquivo suporte todos os parâmetros tempo arquivo. Armazenar o objeto Windows Embedded CE armazena somente um arquivo tempo e pode ser definido por qualquer uma das três parâmetros.

Requirements

Header	winbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Time Functions
GetFileTime
FILETIME

Other Resources

CeSetFileTime (RAPI)
GetFileSize
Timer Driver Reference