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
值 | 意義 |
---|---|
|
通知會使用WM_POWERBROADCAST訊息與 PBT_POWERSETTINGCHANGE的wParam參數來傳送。 |
|
通知會傳送至 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) |