SetActivePwrScheme

アクティブな電源スキームを設定する。

SetActivePwrScheme uiID, pGlobalPowerPolicy, pPowerPolicy

uiID : [int] アクティブにする電源スキームのインデックス。
pGlobalPowerPolicy : [var] オプションの GLOBAL_POWER_POLICY 構造体へのポインタ。電源スキームがアクティブになるときにマージされるグローバル電源ポリシー設定を提供する。
pPowerPolicy : [var] オプションの POWER_POLICY 構造体へのポインタ。電源スキームがアクティブになるときにマージされる電源ポリシー設定を提供する。

(プラグイン / モジュール : powrprof.dll)

解説

アクティブな電源スキームを設定する。

[戻り値]
関数が成功すると、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼び出す。

[備考]
システム構成を長期的に変更する用途に使用する。アプリケーション実行中に一時的にシステムを稼働させ続けたい場合は
SetThreadExecutionState を使う。uiID の電源スキームが存在しない場合、関数は 0
を返す。lpGlobalPowerPolicy が NULL の場合、関数は WriteGlobalPwrPolicy
で設定済みの現在のグローバル電源ポリシー設定を使用する。そうでなければ指定した構造体の設定で置き換える。lpPowerPolicy が
NULL の場合、電源スキームの現在の電源ポリシー設定を使用する。そうでなければ指定した構造体の設定で置き換える。PowrProf.h
の使用方法の詳細は Power Schemes を参照。

情報