共用方式為

RegisterPowerSettingNotification 函式 (winuser.h)

  • 發行項

註冊應用程式以接收特定電源設定事件的電源設定通知。

語法

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

參數

[in] hRecipient

控制碼，指出要傳送電源設定通知的位置。 對於互動式應用程式， Flags 參數應該是零， 而 hRecipient 參數應該是視窗控制碼。 對於服務，Flags參數應該是一個，而 hRecipient參數應該是從RegisterServiceCtrlHandlerEx傳回的SERVICE_STATUS_HANDLE。

[in] PowerSettingGuid

要傳送通知之電源設定的 GUID 。 如需詳細資訊，請參閱 註冊 Power Events。

[in] Flags

值 意義
DEVICE_NOTIFY_WINDOW_HANDLE
0
 通知會使用WM_POWERBROADCAST訊息與 PBT_POWERSETTINGCHANGE的wParam參數來傳送。
DEVICE_NOTIFY_SERVICE_HANDLE
1
 通知會傳送至 HandlerEx 回呼函式，其中 dwControl 參數為 SERVICE_CONTROL_POWEREVENT 和 dwEventType 為 PBT_POWERSETTINGCHANGE。

傳回值

傳回通知控制碼，用於取消註冊電源通知。 如果函式失敗，傳回值為 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