WriteGlobalPwrPolicy 関数 (powrprof.h)
[WriteGlobalPwrPolicy は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 「解説」を参照してください。
グローバル電源ポリシー設定を書き込みます。
構文
BOOLEAN WriteGlobalPwrPolicy(
[in] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);
パラメーター
[in] pGlobalPowerPolicy
書き込む電源ポリシー設定を含む GLOBAL_POWER_POLICY 構造体へのポインター。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
関数は、既存のグローバル電源ポリシー設定を置き換えます。 各ユーザーには個別のグローバル電源スキームがあり、そのユーザーのすべての電源スキームに適用される電源ポリシー設定が含まれています。
Windows Vista 以降では、 PowerEnumerate 関数を使用して、指定したスキームの電源設定を列挙し、電源書き込み関数を使用して個々の設定を書き込みます。
PowrProf.h の使用方法の詳細については、「 Power Schemes」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | powrprof.h |
| Library | PowrProf.lib |
| [DLL] | PowrProf.dll |