Функция RegisterSuspendResumeNotification (winuser.h)

Статья
03/04/2024

Регистрируется для получения уведомлений о приостановке или возобновлении работы системы. Аналогично 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

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS

UnregisterSuspendResumeNotification

Поделиться через