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 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

전원 관리 함수

SYSTEM_POWER_STATUS

시스템 전원 상태