ReadGlobalPwrPolicy 関数 (powrprof.h)

[ReadGlobalPwrPolicy は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 「解説」を参照してください。

現在のグローバル電源ポリシー設定を取得します。

構文

BOOLEAN ReadGlobalPwrPolicy(
  [out] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);

パラメーター

[out] pGlobalPowerPolicy

情報を受け取る GLOBAL_POWER_POLICY 構造体へのポインター。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

GLOBAL_POWER_POLICY構造には、すべての電源スキームに共通するポリシー設定が含まれています。 この構造には、ユーザーとコンピューターの両方のポリシー設定が含まれています。

Windows Vista 以降では、 PowerEnumerate 関数を使用して、指定したスキームの電源設定を列挙し、電源読み取り関数を使用して個々の設定を取得します。

PowrProf.h の使用方法の詳細については、「 Power Schemes」を参照してください。

要件

要件
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー powrprof.h
Library PowrProf.lib
[DLL] PowrProf.dll

こちらもご覧ください

GLOBAL_POWER_POLICY

Power Management Functions

WriteGlobalPwrPolicy