Функция RegisterSuspendResumeNotification (winuser.h)
Регистрируется для получения уведомлений о приостановке или возобновлении работы системы. Аналогично PowerRegisterSuspendResumeNotification, но работает в пользовательском режиме и может принимать дескриптор окна.
Синтаксис
HPOWERNOTIFY RegisterSuspendResumeNotification(
[in] HANDLE hRecipient,
[in] DWORD Flags
);
Параметры
[in] hRecipient
Этот параметр содержит параметры для подписки на уведомление power или дескриптор окна, представляющий процесс подписки.
Если параметр FlagsDEVICE_NOTIFY_CALLBACK,hRecipient интерпретируется как указатель на структуру DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS . В этом случае функция обратного вызова — DeviceNotifyCallbackRoutine. При выполнении функции Callback задается параметр Type , указывающий тип произошедшего события. Возможные значения: PBT_APMSUSPEND, PBT_APMRESUMESUSPEND и PBT_APMRESUMEAUTOMATIC . Дополнительные сведения см. в разделе События управления питанием . Параметр Setting не используется с уведомлениями о приостановке и возобновлении.
Если флагиDEVICE_NOTIFY_WINDOW_HANDLE, hRecipient — это дескриптор окна для доставки событий.
[in] Flags
Этот параметр может быть DEVICE_NOTIFY_WINDOW_HANDLE или DEVICE_NOTIFY_CALLBACK.
Возвращаемое значение
Дескриптор регистрации. Используйте этот дескриптор для отмены регистрации уведомлений.
Если функция завершается сбоем, возвращается значение NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winuser.h |
| Библиотека | User32.lib |
| DLL | User32.dll |
| Набор API | ext-ms-win-ntuser-powermanagement-l1-1-0 (появилось в Windows 8) |
См. также раздел
DEVICE_NOTIFY_CALLBACK_ROUTINE