Função SetSystemTime (sysinfoapi.h)

Define a hora e a data atuais do sistema. A hora do sistema é expressa em UTC (Tempo Universal Coordenado).

Sintaxe

BOOL SetSystemTime(
  [in] const SYSTEMTIME *lpSystemTime
);

Parâmetros

[in] lpSystemTime

Um ponteiro para uma estrutura SYSTEMTIME que contém a nova data e hora do sistema.

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 é desabilitado por padrão. A função SetSystemTime habilita o privilégio SE_SYSTEMTIME_NAME antes de alterar a hora do sistema e desabilita o privilégio antes de retornar. Para obter mais informações, confira Executar com privilégios especiais.

Requisitos

Confira também

Getsystemtime

SYSTEMTIME

SetSystemTimeAdjustment

Hora do sistema

Funções de tempo