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 |