RegisterPowerSettingNotification 함수(winuser.h)

애플리케이션을 등록하여 특정 전원 설정 이벤트에 대한 전원 설정 알림을 받습니다.

구문

HPOWERNOTIFY RegisterPowerSettingNotification(
  [in] HANDLE  hRecipient,
  [in] LPCGUID PowerSettingGuid,
  [in] DWORD   Flags
);

매개 변수

[in] hRecipient

전원 설정 알림을 보낼 위치를 나타내는 핸들입니다. 대화형 애플리케이션의 경우 Flags 매개 변수는 0이어야 하며 hRecipient 매개 변수는 창 핸들이어야 합니다. 서비스의 경우 Flags 매개 변수는 하나여야 하며 hRecipient 매개 변수는 RegisterServiceCtrlHandlerEx에서 반환된 SERVICE_STATUS_HANDLE 합니다.

[in] PowerSettingGuid

알림을 보낼 전원 설정의 GUID 입니다. 자세한 내용은 전원 이벤트 등록을 참조하세요.

[in] Flags

값	의미
DEVICE_NOTIFY_WINDOW_HANDLE 0	wParam 매개 변수가 PBT_POWERSETTINGCHANGE WM_POWERBROADCAST 메시지를 사용하여 알림이 전송됩니다.
DEVICE_NOTIFY_SERVICE_HANDLE 1	알림은 SERVICE_CONTROL_POWEREVENT dwControl 매개 변수 및 PBT_POWERSETTINGCHANGEdwEventType을 사용하여 HandlerEx 콜백 함수로 전송됩니다.

반환 값

전원 알림 등록 취소에 대한 알림 핸들을 반환합니다. 함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-powermanagement-l1-1-0(Windows 8에서 도입)

추가 정보

전원 관리 함수

전원 이벤트 등록

UnregisterPowerSettingNotification