Windows 系統電源管理：以 SetSystemPowerState 實作強制休眠與關機

企業環境常要求下班自動關機節能，但標準關機 API 常因電源管理設定導致「可安全關閉電腦」提示而無法真正斷電。本文深入解析 SetSystemPowerState API 的進階用法，展示如何繞過 ACPI 限制直接切斷電源，並完整封裝權限提升與錯誤處理邏輯。

問題背景與 API 選擇

常見關機 API 比較：

核心實作：權限提升與電源狀態切換

完整封裝函數包含權限調整、錯誤處理與資源清理：

void PERR(LPTSTR szAPI, DWORD dwLastError);
#define RTN_ERROR 13

INT SetPower()
{
    TOKEN_PRIVILEGES tp;
    HANDLE hToken;
    LUID luid;
    LPTSTR MachineName = NULL;

    // 1. 開啟進程權杖並請求調整權限
    if (!OpenProcessToken(GetCurrentProcess(), TOKEN_ADJUST_PRIVILEGES, &hToken))
    {
        PERR("OpenProcessToken", GetLastError());
        return RTN_ERROR;
    }

    // 2. 取得 SE_SHUTDOWN_NAME 權限的 LUID
    if (!LookupPrivilegeValue(MachineName, SE_SHUTDOWN_NAME, &luid))
    {
        PERR("LookupPrivilegeValue", GetLastError());
        CloseHandle(hToken);
        return RTN_ERROR;
    }

    // 3. 啟用關機權限
    tp.PrivilegeCount = 1;
    tp.Privileges[0].Luid = luid;
    tp.Privileges[0].Attributes = SE_PRIVILEGE_ENABLED;
    
    if (!AdjustTokenPrivileges(hToken, FALSE, &tp, sizeof(TOKEN_PRIVILEGES), NULL, NULL))
    {
        PERR("AdjustTokenPrivileges", GetLastError());
        CloseHandle(hToken);
        return RTN_ERROR;
    }

    // 4. 執行系統電源狀態切換
    // fSuspend=FALSE: 關機/休眠而非待機
    // fForce=TRUE: 強制執行，不等待應用程式回應
    if (!SetSystemPowerState(FALSE, TRUE))
    {
        PERR("SetSystemPowerState", GetLastError());
        CloseHandle(hToken);
        return RTN_ERROR;
    }

    CloseHandle(hToken);
    return 0;
}

// 完善的錯誤報告函數
void PERR(LPTSTR szAPI, DWORD dwLastError)
{
    LPTSTR MessageBuffer;
    DWORD dwBufferLength;
    
    fprintf(stderr, "%s error! (rc=%lu)\n", szAPI, dwLastError);
    
    if (dwBufferLength = FormatMessage(
        FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM,
        NULL, dwLastError, LANG_NEUTRAL,
        (LPTSTR)&MessageBuffer, 0, NULL))
    {
        DWORD dwBytesWritten;
        WriteFile(GetStdHandle(STD_ERROR_HANDLE), MessageBuffer, dwBufferLength, &dwBytesWritten, NULL);
        LocalFree(MessageBuffer);
    }
}

關鍵技術細節解析

1. 權限提升機制

Windows 安全模型要求敏感操作需具備對應權限。SE_SHUTDOWN_NAME 權限預設僅授予 Administrators 群組，普通用戶需透過 AdjustTokenPrivileges 啟用。

2. SetSystemPowerState 參數詳解

BOOL SetSystemPowerState(
    BOOL fSuspend,  // TRUE=休眠/待機, FALSE=關機/休眠(視系統支援)
    BOOL fForce     // TRUE=強制執行, FALSE=正常流程
);

組合效果：

• (FALSE, TRUE)：強制關機並斷電（本文目標）
• (TRUE, TRUE)：強制休眠
• (FALSE, FALSE)：標準關機流程（可能被攔截）

3. 系統相容性需求

• 作業系統：Windows 2000 / XP / Server 2003 及以上
• BIOS/硬體：需支援 ACPI 電源管理
• 系統設定：控制台 → 電源選項 → 休眠標籤 → 啟用休眠支援

實務部署策略：排程任務整合

為避免常駐程式佔用資源，建議配合 Windows 排程任務：

1. 將上述程式碼編譯為獨立執行檔（如 ForceShutdown.exe）
2. 建立排程任務，於下班時間觸發執行
3. 設定「以最高權限執行」確保權限提升成功
4. 配置「若任務執行超過 X 分鐘則停止」防止異常殘留

常見問題排查

總結

SetSystemPowerState 結合權限提升機制，提供了繞過標準關機流程限制的強力方案。實務應用時需注意權限模型、硬體相容性與錯誤處理，配合排程任務可構建零干擾的自動化電源管理方案。