Compartilhar via


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

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

Confira também

Getsystemtime

SYSTEMTIME

SetSystemTimeAdjustment

Hora do sistema

Funções de tempo