using System;
using System.Runtime.InteropServices;
using System.Threading;
using System.Threading.Tasks;
namespace YuncangTrace.LocalService.Services;
///
/// 把本机系统时钟校准到 NTP 时间。
///
/// ⚠️ 修改系统时间需要管理员权限(本软件默认以普通权限运行,非管理员时会由
/// 拉起提权 helper 执行本类的 ),
/// 并且要先把当前进程令牌里的 SeSystemtimePrivilege 打开,
/// 否则 SetSystemTime 会失败(错误 1314)。
///
/// 现场根因:Windows Time 服务没启动时本机会慢慢变慢(实测差了近 10 秒),
/// 扫码时间是本机时钟打的、回放按录像机时间定位,差几秒面单就被截到回放窗口外。
///
public static class ClockSyncService
{
/// 小于这个偏差就不动系统时间(避免频繁触发系统时间变更事件)
public static readonly TimeSpan MinimumAdjust = TimeSpan.FromMilliseconds(200);
/// 查询 + 校准,返回本次查询结果(即使偏差很小也会返回)。
public static async Task SyncAsync(string server, int timeoutMs = 3000, CancellationToken ct = default)
{
var result = await NtpClient.QueryAsync(server, timeoutMs, ct).ConfigureAwait(false);
Apply(result.Offset);
return result;
}
///
/// 按偏差调整系统时间(UTC 写入)。
///
/// 没有权限 / SetSystemTime 失败
public static void Apply(TimeSpan offset)
{
if (offset.Duration() < MinimumAdjust) return;
if (!EnableSystemTimePrivilege())
{
throw new InvalidOperationException("没有修改系统时间的权限,请以管理员身份运行本软件");
}
var time = ToSystemTime(DateTime.UtcNow.Add(offset));
if (!SetSystemTime(ref time))
{
var error = Marshal.GetLastWin32Error();
throw new InvalidOperationException($"设置系统时间失败(错误 {error}),请以管理员身份运行本软件");
}
}
/// 当前进程是否以管理员身份运行(给界面提示用)
public static bool IsElevated
{
get
{
try
{
using var identity = System.Security.Principal.WindowsIdentity.GetCurrent();
var principal = new System.Security.Principal.WindowsPrincipal(identity);
return principal.IsInRole(System.Security.Principal.WindowsBuiltInRole.Administrator);
}
catch
{
return false;
}
}
}
// ==================== Win32 ====================
private const uint TokenAdjustPrivileges = 0x0020;
private const uint TokenQuery = 0x0008;
private const uint SePrivilegeEnabled = 0x00000002;
[StructLayout(LayoutKind.Sequential)]
private struct Luid
{
public uint LowPart;
public int HighPart;
}
[StructLayout(LayoutKind.Sequential)]
private struct LuidAndAttributes
{
public Luid Luid;
public uint Attributes;
}
[StructLayout(LayoutKind.Sequential)]
private struct TokenPrivileges
{
public uint PrivilegeCount;
public LuidAndAttributes Privilege;
}
[StructLayout(LayoutKind.Sequential)]
private struct SystemTime
{
public ushort Year;
public ushort Month;
public ushort DayOfWeek;
public ushort Day;
public ushort Hour;
public ushort Minute;
public ushort Second;
public ushort Milliseconds;
}
[DllImport("advapi32.dll", SetLastError = true)]
private static extern bool OpenProcessToken(IntPtr processHandle, uint desiredAccess, out IntPtr tokenHandle);
[DllImport("advapi32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
private static extern bool LookupPrivilegeValue(string? systemName, string name, out Luid luid);
[DllImport("advapi32.dll", SetLastError = true)]
private static extern bool AdjustTokenPrivileges(IntPtr tokenHandle, bool disableAllPrivileges,
ref TokenPrivileges newState, uint bufferLength, IntPtr previousState, IntPtr returnLength);
[DllImport("kernel32.dll", SetLastError = true)]
private static extern bool SetSystemTime(ref SystemTime systemTime);
[DllImport("kernel32.dll")]
private static extern IntPtr GetCurrentProcess();
[DllImport("kernel32.dll", SetLastError = true)]
private static extern bool CloseHandle(IntPtr handle);
private static bool EnableSystemTimePrivilege()
{
if (!OpenProcessToken(GetCurrentProcess(), TokenAdjustPrivileges | TokenQuery, out var token))
{
return false;
}
try
{
if (!LookupPrivilegeValue(null, "SeSystemtimePrivilege", out var luid)) return false;
var privileges = new TokenPrivileges
{
PrivilegeCount = 1,
Privilege = new LuidAndAttributes { Luid = luid, Attributes = SePrivilegeEnabled },
};
if (!AdjustTokenPrivileges(token, false, ref privileges, 0, IntPtr.Zero, IntPtr.Zero)) return false;
// AdjustTokenPrivileges 在「部分成功」时也返回 true,必须再查一次错误码
return Marshal.GetLastWin32Error() == 0;
}
finally
{
CloseHandle(token);
}
}
private static SystemTime ToSystemTime(DateTime utc)
{
return new SystemTime
{
Year = (ushort)utc.Year,
Month = (ushort)utc.Month,
DayOfWeek = (ushort)utc.DayOfWeek,
Day = (ushort)utc.Day,
Hour = (ushort)utc.Hour,
Minute = (ushort)utc.Minute,
Second = (ushort)utc.Second,
Milliseconds = (ushort)utc.Millisecond,
};
}
}