Função SetLocalTime (sysinfoapi.h)
Define a hora e a data locais atuais.
Sintaxe
BOOL SetLocalTime(
[in] const SYSTEMTIME *lpSystemTime
);
Parâmetros
[in] lpSystemTime
Um ponteiro para uma estrutura SYSTEMTIME que contém a nova data e hora locais.
O membro wDayOfWeek da estrutura SYSTEMTIME é ignorado.
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
O processo de chamada deve ter o privilégio SE_SYSTEMTIME_NAME. Esse privilégio está desabilitado por padrão. A função SetLocalTime habilita o privilégio SE_SYSTEMTIME_NAME antes de alterar a hora local e desabilita o privilégio antes de retornar. Para obter mais informações, confira Executar com privilégios especiais.
O sistema usa UTC internamente. Portanto, quando você chama SetLocalTime, o sistema usa as informações de fuso horário atuais para executar a conversão, incluindo a configuração de horário de verão. Observe que o sistema usa a configuração de horário de verão da hora atual, não a nova hora que você está configurando. Portanto, para garantir o resultado correto, chame SetLocalTime uma segunda vez, agora que a primeira chamada atualizou a configuração de horário de verão.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | sysinfoapi.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |