IConsolePowerSink::OnPowerBroadcast 메서드(mmc.h)
OnPowerBroadcast 메서드는 컴퓨터의 전원 관리와 관련된 WM_POWERBROADCAST 알림 메시지를 처리합니다.
구문
HRESULT OnPowerBroadcast(
[in] UINT nEvent,
[in] LPARAM lParam,
[out] LRESULT *plReturn
);
매개 변수
[in] nEvent
전원 브로드캐스트 이벤트 식별자입니다. 식별자는 다음 값 중 하나입니다.
PBT_APMBATTERYLOW
배터리 양이 부족합니다.
PBT_APMOEMEVENT
OEM 정의 이벤트가 발생했습니다.
PBT_APMPOWERSTATUSCHANGE
전원 상태 변경되었습니다.
PBT_APMQUERYSUSPEND
일시 중단 권한을 요청합니다.
PBT_APMQUERYSUSPENDFAILED
일시 중단 요청이 거부되었습니다.
PBT_APMRESUMEAUTOMATIC
이벤트 후 자동으로 다시 시작될 수 있습니다.
PBT_APMRESUMECRITICAL
중요 일시 중단 후 작업이 재개됩니다.
PBT_APMRESUMESUSPEND
일시 중단 후 작업이 재개됩니다.
PBT_APMSUSPEND
시스템이 작업을 일시 중단합니다.
[in] lParam
함수별 데이터입니다. 대부분의 이벤트의 경우 이 매개 변수는 예약되어 있으며 사용되지 않습니다. 그러나 nEvent 가 다시 시작 이벤트(PBT_APMRESUME*) 중 하나인 경우 lParam 매개 변수는 PBTF_APMRESUMEFROMFAILURE 플래그를 지정할 수 있습니다. 이 플래그는 PBT_APMSUSPEND 이벤트가 브로드캐스트된 후 일시 중단 작업이 실패했음을 나타냅니다.
[out] plReturn
반환 시 브로드캐스트 이벤트에 대한 스냅인의 응답입니다. 일반적으로 *plReturn 을 TRUE로 설정합니다. 예외는 nEvent가 PBT_APMQUERYSUSPEND 경우입니다. PBT_APMQUERYSUSPEND 이벤트에 대한 응답으로 컴퓨터 일시 중단을 계속하려면 *plReturn 을 TRUE로 설정합니다. 컴퓨터 일시 중단을 거부하려면 *plReturn 을 BROADCAST_QUERY_DENY 설정합니다. 컴퓨터 일시 중단을 허용하는 스냅인은 이 메서드에서 반환하기 전에 필요한 일시 중단 준비를 수행해야 합니다.
반환 값
성공하면 반환 값이 S_OK. 다른 반환 값은 오류 코드를 나타냅니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | mmc.h |