SetActivePwrScheme 函式 (powrprof.h)

發行項
03/01/2024

[SetActivePwrScheme 可用於需求一節中指定的操作系統。它在後續版本中可能會變更或無法使用。針對 Windows Vista 和更新版本撰寫的應用程式應該改用 PowerSetActiveScheme 。]

設定使用中電源配置。

語法

BOOLEAN SetActivePwrScheme(
  [in]           UINT                 uiID,
  [in, optional] PGLOBAL_POWER_POLICY pGlobalPowerPolicy,
  [in, optional] PPOWER_POLICY        pPowerPolicy
);

參數

[in] uiID

要啟動之電源配置的索引。

[in, optional] pGlobalPowerPolicy

選擇性 GLOBAL_POWER_POLICY 結構的指標，提供當電源配置變成使用中時要與電源配置合併的全域電源原則設定。

[in, optional] pPowerPolicy

選擇性 POWER_POLICY 結構的指標，可提供電源原則設定，以在電源配置變成使用中時與電源配置合併。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

使用此函式對系統組態進行長期變更。若要在應用程式執行工作時暫時讓系統保持執行狀態，請使用 SetThreadExecutionState 函式。

如果 uiID 指定的電源配置不存在，函式會傳回零。

如果 lpGlobalPowerPolicy 為 NULL，函式會使用 WriteGlobalPwrPolicy 所設定的目前全域電源原則設定。否則，指定結構中的設定會取代目前的全域電源原則設定。

如果 lpPowerPolicy 為 NULL，函式會使用電源配置的目前電源原則設定。否則，指定結構中的設定會取代目前的電源原則設定。

如需使用 PowrProf.h 的詳細資訊，請參閱 Power Schemes。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	powrprof.h
程式庫	PowrProf.lib
Dll	PowrProf.dll