RegisterSuspendResumeNotification 函式 (winuser.h)
註冊以在系統暫停或繼續時接收通知。 類似於 PowerRegisterSuspendResumeNotification,但在使用者模式中運作,而且可以接受視窗句柄。
語法
HPOWERNOTIFY RegisterSuspendResumeNotification(
[in] HANDLE hRecipient,
[in] DWORD Flags
);
參數
[in] hRecipient
此參數包含訂閱電源通知的參數,或代表訂閱程式的視窗句柄。
如果 Flags是DEVICE_NOTIFY_CALLBACK,hRecipient 會解譯為DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS結構的指標。 在此情況下,回呼函式為 DeviceNotifyCallbackRoutine。 當 Callback 函式執行時, 會設定 Type 參數,指出發生的事件類型。 可能的值包括 PBT_APMSUSPEND、 PBT_APMRESUMESUSPEND和 PBT_APMRESUMEAUTOMATIC - 如需詳細資訊,請參閱 電源管理事件 。 設定參數不會與暫停/繼續通知搭配使用。
如果 Flags是DEVICE_NOTIFY_WINDOW_HANDLE,hRecipient 是用來傳遞事件的視窗句柄。
[in] Flags
此參數可以是 DEVICE_NOTIFY_WINDOW_HANDLE 或 DEVICE_NOTIFY_CALLBACK。
傳回值
註冊的句柄。 使用此句柄取消註冊通知。
如果函式失敗,則傳回值為 NULL。 若要取得擴充錯誤資訊,請呼叫 GetLastError。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winuser.h |
程式庫 | User32.lib |
Dll | User32.dll |
API 集合 | ext-ms-win-ntuser-powermanagement-l1-1-0 (於 Windows 8) |
另請參閱
DEVICE_NOTIFY_CALLBACK_ROUTINE