getSystemPowerStatus 函式 (winbase.h)

擷取系統的電源狀態。 狀態會指出系統是否在 AC 或 DC 電源上執行、電池目前是否正在充電、剩餘的電池使用時間,以及省電模式是否開啟或關閉。

語法

BOOL GetSystemPowerStatus(
  [out] LPSYSTEM_POWER_STATUS lpSystemPowerStatus
);

參數

[out] lpSystemPowerStatus

接收狀態資訊 之SYSTEM_POWER_STATUS 結構的指標。

傳回值

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

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

備註

若要編譯使用此函式的應用程式,請將_WIN32_WINNT宏定義為0x0400或更新版本。 如需詳細資訊,請參閱 使用 Windows 標頭

規格需求

需求
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

電源管理功能

SYSTEM_POWER_STATUS

系統電源狀態