Função SetLocalTime (sysinfoapi.h)

Artigo
08/26/2023

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