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 |