Função SystemTimeToFileTime (timezoneapi.h)

Artigo
03/05/2024

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