Windows任务栏进度条必须通过ITaskbarList3 COM接口实现，需先CoInitialize、注册窗口类并创建有效HWND，SetProgressValue参数须为0–100整数且调用须在UI线程，状态由SetProgressState控制，释放前需确保正确RAII管理。
Windows任务栏进度条需要启用TaskbarList接口
直接调用SetThreadExecutionState或修改窗口样式无法触发任务栏进度显示——必须通过COM接口ITaskbarList3向系统注册并更新进度状态。该接口仅在Windows 7及以上生效，且要求程序拥有有效窗口句柄（HWND），控制台程序需先创建隐藏窗口或挂载到GUI进程。
初始化ITaskbarList3前必须CoInitialize并注册窗口类
常见错误是跳过COM初始化或未确保窗口已注册：调用CoInitialize(nullptr)后，需用RegisterClassEx注册窗口类，并创建可见/不可见窗口（哪怕WS_POPUP | WS_DISABLED），否则SHGetDesktopFolder后续调用会失败或静默忽略进度设置。
- 务必检查
CoCreateInstance返回值是否为S_OK，失败时ITaskbarList3*为空指针 - 窗口必须已调用
ShowWindow（哪怕SW_HIDE），否则系统不将其视为“可管理任务栏项” - 若使用多线程更新进度，所有
SetProgressValue调用必须在UI线程执行（不能在工作线程直接调）
SetProgressValue参数范围和状态类型决定显示效果
SetProgressValue(hwnd, current, total)中current和total必须为0–100之间的整数（非百分比值，而是归一化刻度），超出范围会导致进度条消失或卡死。状态由SetProgressState控制，常用值：TBPF_NORMAL（绿色填充）、TBPF_INDETERMINATE（循环动画）、TBPF_ERROR（红色）、TBPF_PAUSED（黄色）。
// 示例：更新到65% taskbar->SetProgressValue(hwnd, 65, 100); taskbar->SetProgressState(hwnd, TBPF_NORMAL);
- 频繁调用（如每毫秒）会引发闪烁，建议限制在20ms以上间隔
- 若
current > total，进度条会显示为满格但无动画；若total == 0，行为未定义，可能崩溃 - 最小化窗口时进度条仍可见，但若程序被系统休眠（如锁屏），更新将失效，需监听
WM_POWERBROADCAST恢复
释放ITaskbarList3时必须调用Release且避免重复释放
对象生命周期必须严格匹配：CoCreateInstance成功后获得的ITaskbarList3*指针，只应在程序退出前调用一次Release()。多次调用或空指针调用Release()会导致访问违规。建议用RAII包装：
立即学习“C++免费学习笔记（深入）”；
struct TaskbarProgress {
ITaskbarList3* taskbar = nullptr;
TaskbarProgress() { CoInitialize(nullptr); }
~TaskbarProgress() {
if (taskbar) taskbar->Release();
CoUninitialize();
}
};
实际项目中容易忽略的是：DLL插件或热重载场景下，可能多次初始化COM环境，导致CoUninitialize()提前释放全局状态，进而使后续SetProgressValue静默失败。
