GetSystemPowerStatus 関数 (winbase.h)

システムの電源状態を取得します。 状態は、システムが AC 電源と DC 電源のどちらで動作しているか、バッテリーが現在充電されているかどうか、バッテリーの寿命がどれくらい残っているか、バッテリー 節約機能がオンかオフかを示します。

構文

BOOL GetSystemPowerStatus(
  [out] LPSYSTEM_POWER_STATUS lpSystemPowerStatus
);

パラメーター

[out] lpSystemPowerStatus

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

戻り値

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

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

解説

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT マクロを 0x0400 以降として定義します。 詳細については、「 Windows ヘッダーの使用」を参照してください。

要件

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

関連項目

Power Management Functions

SYSTEM_POWER_STATUS

システム電源の状態