Fonction RegisterAppStateChangeNotification (appnotify.h)

  • Article

Permet à une application d’inscrire une fonction de rappel par le biais de laquelle elle peut être avertie que sa bibliothèque entre ou sort d’un état suspendu. L’application peut utiliser ces informations pour effectuer toutes les opérations nécessaires, telles que la conservation de l’état, qui doivent être effectuées à ce stade.

Syntaxe

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

Paramètres

[in] Routine

Pointeur vers une fonction de rappel appelée lorsque l’application entre ou quitte l’état suspendu. Pour plus d’informations sur cette fonction , consultez PAPPSTATE_CHANGE_ROUTINE .

[in, optional] Context

Informations de contexte spécifiques à l’application que l’application utilise lors de l’entrée ou de la sortie d’un état suspendu. Il s’agit généralement d’un pointeur « this ».

[out] Registration

Lorsque cette fonction retourne correctement, ce paramètre reçoit l’adresse d’un pointeur vers une valeur qui peut être utilisée pour identifier l’inscription. Stockez cette valeur à utiliser avec UnregisterAppStateChangeNotification.

Valeur retournée

Code de status Win32 standard.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête appnotify.h
Bibliothèque Appnotify.lib
DLL Twinapi.core.dll

Voir aussi

UnregisterAppStateChangeNotification