readPwrScheme 函式 (powrprof.h)

[ReadPwrScheme 可用於需求一節中指定的操作系統。它在後續版本中可能會變更或無法使用。請參閱備註。]

擷取指定電源配置唯一的電源原則設定。

語法

BOOLEAN ReadPwrScheme(
  [in]  UINT          uiID,
  [out] PPOWER_POLICY pPowerPolicy
);

[in] uiID

要讀取的電源配置索引。

[out] pPowerPolicy

接收電源原則設定之POWER_POLICY 結構的指標。

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

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

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

若要擷取系統目前使用中電源原則設定的相關信息，請呼叫 GetActivePwrScheme 函式。若要擷取目前電源原則設定的其他資訊，請呼叫 CallNtPowerInformation 函式。

從 Windows Vista 開始，使用 PowerEnumerate 函式來列舉指定配置的電源設定，以及用來擷取個別設定的電源讀取函式。

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