Compartilhar via


Função SystemTimeToFileTime (timezoneapi.h)

Converte um formato de hora do sistema em tempo de arquivo. A hora do sistema é baseada no UTC (Tempo Universal Coordenado).

Sintaxe

BOOL SystemTimeToFileTime(
  [in]  const SYSTEMTIME *lpSystemTime,
  [out] LPFILETIME       lpFileTime
);

Parâmetros

[in] lpSystemTime

Um ponteiro para uma estrutura SYSTEMTIME que contém a hora do sistema a ser convertida de UTC para o formato de hora do arquivo.

O membro wDayOfWeek da estrutura SYSTEMTIME é ignorado.

[out] lpFileTime

Um ponteiro para uma estrutura FILETIME para receber a hora do sistema convertida.

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.

Observação

Um valor retornado False pode indicar que a estrutura SYSTEMTIME passada representa uma data inválida. Determinadas situações, como o dia adicional adicionado em um ano bissexto, podem resultar na criação inesperada de uma data inválida na lógica do aplicativo. Para obter mais informações sobre como evitar esses problemas, consulte preparação para o ano bissexto.

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]
Plataforma de Destino Windows
Cabeçalho timezoneapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

DosDateTimeToFileTime

FILETIME

FileTimeToDosDateTime

FileTimeToSystemTime

SYSTEMTIME

Hora do sistema

Funções de tempo