PowerSettingRegisterNotification 함수(powersetting.h)

전원 설정이 변경될 때 알림을 받도록 등록합니다.

구문

DWORD PowerSettingRegisterNotification(
  [in]  LPCGUID       SettingGuid,
  [in]  DWORD         Flags,
  [in]  HANDLE        Recipient,
  [out] PHPOWERNOTIFY RegistrationHandle
);

매개 변수

[in] SettingGuid

전원 설정을 나타내는 GUID입니다.

[in] Flags

알림 수신자에 대한 정보입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
DEVICE_NOTIFY_SERVICE_HANDLE	Recipient 매개 변수는 서비스에 대한 핸들입니다. CreateService 또는 OpenService 함수를 사용하여 이 핸들을 가져옵니다.
DEVICE_NOTIFY_CALLBACK	Recipient 매개 변수는 전원 설정이 변경되면 호출할 콜백 함수에 대한 포인터입니다. 이 경우 받는 사람은PDEVICE_NOTIFY_SUBSCRIBE_PARAMETERS 형식이어야 합니다.

[in] Recipient

알림 수신자에 대한 핸들입니다.

[out] RegistrationHandle

등록에 대한 핸들입니다. 이 핸들을 사용하여 알림 등록을 취소합니다.

반환 값

호출에 성공하면 ERROR_SUCCESS(0)을 반환하고, 호출이 실패한 경우 0이 아닌 값을 반환합니다.

설명

등록 직후 전원 설정의 현재 값으로 콜백이 호출됩니다. 전원 설정이 변경되는 동안 등록이 발생하는 경우 여러 콜백을 받을 수 있습니다. 마지막 콜백은 최신 업데이트입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	powersetting.h
라이브러리	Powrprof.lib
DLL	Powrprof.dll

추가 정보

전원 설정 GUID

PowerSettingUnregisterNotification