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


Функция RegisterAppStateChangeNotification (appnotify.h)

Позволяет приложению зарегистрировать функцию обратного вызова, с помощью которой оно может получать уведомления о том, что его библиотека переходит в приостановленное состояние или выходит из нее. Приложение может использовать эти сведения для выполнения любых необходимых операций, таких как сохранение состояния, которые должны быть выполнены в этот момент.

Синтаксис

APICONTRACT ULONG RegisterAppStateChangeNotification(
  [in]           PAPPSTATE_CHANGE_ROUTINE Routine,
  [in, optional] PVOID                    Context,
  [out]          PAPPSTATE_REGISTRATION   *Registration
);

Параметры

[in] Routine

Указатель на функцию обратного вызова, которая вызывается, когда приложение переходит в приостановленное состояние или выходит из нее. Дополнительные сведения об этой функции см. в PAPPSTATE_CHANGE_ROUTINE .

[in, optional] Context

Сведения о контексте приложения, которые приложение использует при переходе в приостановленное состояние или выходе из него. Обычно это указатель "this".

[out] Registration

При успешном возврате этой функции этот параметр получает адрес указателя на значение, которое можно использовать для идентификации регистрации. Сохраните это значение для использования с UnregisterAppStateChangeNotification.

Возвращаемое значение

Стандартный код состояния Win32.

Требования

Требование Значение
Целевая платформа Windows
Header appnotify.h
Библиотека Appnotify.lib
DLL Twinapi.core.dll

См. также раздел

Отмена регистрацииAppStateChangeNotification