必须在调用前用ctypes.windll.shell32.IsUserAnAdmin()主动检测权限，返回1表示有权限、0表示无权限；若缺失则通过ShellExecuteW以"runas"动词自我重启并立即退出，避免静默失败。
需要以管理员权限运行脚本，否则多数 Win32API（如 win32api.SetThreadExecutionState、ctypes.windll.user32.BlockInput、服务控制等）会直接返回拒绝访问错误（pywintypes.error: (5, 'SetThreadExecutionState', '拒绝访问。')）。
如何检测当前 Python 进程是否拥有管理员权限
不能只靠 try-except 捕获错误再提示——很多 API 调用失败时不会抛出 Python 异常，而是静默返回 0 或 False，导致逻辑误判。必须在调用前主动检查。
- 使用
ctypes.windll.shell32.IsUserAnAdmin()是最轻量、最可靠的方式；返回1表示有权限，0表示没有 - 不要依赖
os.getuid() == 0（Windows 下不存在 uid 概念，该调用会报错） - 避免用
subprocess.run(['net', 'session'])等间接方式，启动新进程开销大且可能被 UAC 阻塞
示例：
import ctypes
if not ctypes.windll.shell32.IsUserAnAdmin():
print("请以管理员身份运行此脚本")
exit(1)
如何让脚本自动请求管理员权限（UAC 提升）
手动右键“以管理员身份运行”不可用于自动化场景。需在脚本开头判断权限，并在缺失时自我重启为高权限进程。
立即学习“Python免费学习笔记（深入）”；
- 核心思路：用
shell32.ShellExecuteW重新执行自身，参数中指定"runas"动词 - 必须传递原始命令行参数（如
sys.argv[1:]），否则带参数的脚本会丢失上下文 - 调用后原进程应立即
sys.exit()，避免低权限副本继续执行敏感操作 - 注意：该方法会弹出 Windows UAC 对话框，无法绕过；若部署在无交互环境（如 Windows 服务、Task Scheduler），需改用服务方式或预配置计划任务以最高权限运行
示例（精简版）：
import sys, ctypes, os
if not ctypes.windll.shell32.IsUserAnAdmin():
ctypes.windll.shell32.ShellExecuteW(None, "runas", sys.executable, " ".join(sys.argv), None, 1)
sys.exit()
哪些 Win32API 调用特别容易因权限不足静默失败
不是所有 API 都会明确报错。以下操作在非管理员下常返回 False、0 或空结果，但不抛异常，极易被忽略：
-
win32api.GetKeyboardState和win32api.GetKeyState：读取全局按键状态，无权限时返回全 0 数组 -
ctypes.windll.user32.BlockInput(True)：阻止用户输入，失败时返回0，但脚本仍往下走 -
win32serviceutil.StartService或直接调用OpenSCManager：服务管理类操作，失败时返回None或抛pywintypes.error，但错误码可能是 5（拒绝访问）或 50（不支持的操作） -
win32event.CreateEvent创建跨会话命名事件：普通用户无法在Global\命名空间创建对象，会静默降级到Local\，导致多用户/服务间通信失效
权限问题从来不是“有没有弹窗”的事——关键在于 API 是否真正生效。每次调用后检查返回值、日志记录实际行为，比单纯捕获异常更有效。尤其在远程部署或计划任务中，UAC 提升不可用，必须提前确认执行上下文权限模型。
