readGlobalPwrPolicy 函式 (powrprof.h)
[ReadGlobalPwrPolicy 可用於需求一節中指定的操作系統。 它在後續版本中可能會變更或無法使用。 請參閱備註。]
擷取目前的全域電源原則設定。
語法
BOOLEAN ReadGlobalPwrPolicy(
[out] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);
參數
[out] pGlobalPowerPolicy
接收資訊的GLOBAL_POWER_POLICY結構的指標。
傳回值
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
GLOBAL_POWER_POLICY 結構包含所有電源配置通用的原則設定。 此結構同時包含使用者和計算機原則設定。
從 Windows Vista 開始，使用 PowerEnumerate 函式來列舉指定配置的電源設定，以及用來擷取個別設定的電源讀取函式。
如需使用 PowrProf.h 的詳細資訊，請參閱 Power Schemes。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | powrprof.h |
| 程式庫 | PowrProf.lib |
| Dll | PowrProf.dll |