Função GetSystemTimeAdjustmentPrecise (sysinfoapi.h)
Determina se o sistema está aplicando ajustes periódicos e programados de tempo ao relógio da hora do dia e obtém o valor e o período de tais ajustes.
Sintaxe
BOOL GetSystemTimeAdjustmentPrecise(
[out] PDWORD64 lpTimeAdjustment,
[out] PDWORD64 lpTimeIncrement,
[out] PBOOL lpTimeAdjustmentDisabled
);
Parâmetros
[out] lpTimeAdjustment
Retorna a frequência de atualização do relógio ajustada.
[out] lpTimeIncrement
Retorna a frequência de atualização do relógio.
[out] lpTimeAdjustmentDisabled
Retorna um indicador que especifica se o ajuste de tempo está habilitado.
Um valor true indica que o ajuste periódico está desabilitado. Nesse caso, o sistema pode tentar manter o relógio de hora do dia em sincronia usando seus próprios mecanismos internos. Isso pode fazer com que a hora do dia pule periodicamente para a "hora correta".
Um valor false indica que o ajuste periódico de tempo programado está sendo usado para serializar a hora do dia e o sistema não interferirá ou tentará sincronizar a hora do dia por conta própria.
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
Essa função é usada em algoritmos que sincronizam a hora do dia com outra fonte de tempo, usando um ajuste de relógio programado. Para fazer isso, o sistema calcula a frequência de atualização do relógio ajustada e, em seguida, essa função permite que o chamador obtenha esse valor.
Para obter um exemplo de código completo sobre como habilitar privilégios de tempo do sistema, ajustar o relógio do sistema e exibir valores de relógio, consulte SetSystemTimeAdjustmentPrecise.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 10 [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2016 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | sysinfoapi.h |
Biblioteca | Mincore.lib |
DLL | Api-ms-win-core-version-l1-2-3.dll |