GetSystemTimeAdjustmentPrecise 函数 (sysinfoapi.h)
确定系统是否对其时间时钟应用定期编程时间调整,并获取任何此类调整的值和周期。
语法
BOOL GetSystemTimeAdjustmentPrecise(
[out] PDWORD64 lpTimeAdjustment,
[out] PDWORD64 lpTimeIncrement,
[out] PBOOL lpTimeAdjustmentDisabled
);
参数
[out] lpTimeAdjustment
返回调整后的时钟更新频率。
[out] lpTimeIncrement
返回时钟更新频率。
[out] lpTimeAdjustmentDisabled
返回一个指示符,该指示器指定是否启用时间调整。
值为 TRUE 表示禁用定期调整。 在这种情况下,系统可能会尝试使用自己的内部机制使时间时钟保持同步。 这可能会导致一天中的时间定期跳转到“正确时间”。
值为 FALSE 表示正在使用定期编程时间调整来序列化一天中的时间,并且系统不会自行干扰或尝试同步一天中的时间。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
此函数用于使用编程时钟调整将一天中的时间与另一个时间源同步的算法中。 为此,系统会计算调整后的时钟更新频率,然后此函数允许调用方获取该值。
注意
有关如何启用系统时间权限、调整系统时钟和显示时钟值的完整代码示例,请参阅 SetSystemTimeAdjustmentPrecise。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2016 [仅限桌面应用] |
目标平台 | Windows |
标头 | sysinfoapi.h |
Library | Mincore.lib |
DLL | Api-ms-win-core-version-l1-2-3.dll |