Méthode INotificationActivationCallback ::Activate (notificationactivationcallback.h)

Article
02/29/2024

Appelé lorsqu’un utilisateur interagit avec un toast dans le centre de notifications.

Syntaxe

HRESULT Activate(
  [in] LPCWSTR                            appUserModelId,
  [in] LPCWSTR                            invokedArgs,
  [in] const NOTIFICATION_USER_INPUT_DATA *data,
  [in] ULONG                              count
);

Paramètres

[in] appUserModelId

Identificateur unique représentant votre application sur la plateforme de notification.

[in] invokedArgs

Arguments du bouton appelé. NULL si le toast indique l’activation par défaut et qu’aucun argument de lancement n’a été spécifié dans la charge utile XML.

[in] data

Données des éléments d’entrée disponibles dans le toast de notification.

[in] count

Nombre d’éléments de données .

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Pour que votre application réponde aux toasts dans le centre de notifications, vous devez remplacer cette méthode dans votre application. Vous devez également créer un raccourci dans le menu Démarrer. Pour plus d’informations sur la façon de répondre aux notifications d’activation, consultez Répondre aux activations toast.

Si votre application utilise des toasts non interactifs, vous pouvez y répondre sans utiliser invokedArgs ou des données.

Si vous retournez un code d’échec, l’activation échoue et l’utilisateur peut réessayer d’activer votre application.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	notificationactivationcallback.h

Voir aussi

INotificationActivationCallback

Répondre aux activations toast

Partager via