共用方式為


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

另請參閱

GLOBAL_POWER_POLICY

電源管理功能

WriteGlobalPwrPolicy