Partager via


task_completion_event::set_exception, méthode

Propage une exception à toutes les tâches associées à cet événement.

bool set_exception(
   std::exception_ptr _ExceptionPtr
) const ;

Paramètres

  • _ExceptionPtr
    Exception_ptr qui indique l'exception pour cet événement avec la valeur.

Valeur de retour

Retourne la méthode true si elle a réussi dans la définition de l'exception.Il renvoie false si la task_completion_event a déjà une valeur ou une exception.

Notes

Toutes les deux définies et set_exception peut être appelée plusieurs fois.Lorsqu'une valeur ou une exception ont déjà été définies sur le task_completion_event, un appel à set_exception échoue et renvoie false.Sinon, l'appel aboutit et la fonction renvoie la valeur true.Lorsqu'une exception est définie avec succès sur un task_completion_event, que l'exception doit explicitement être observée par l'utilisateur.Cela est possible en appelant une opération get sur une tâche créée à partir de la task_completion_event, ou en appelant une opération get sur la tâche antecedent continuation basée sur les tâches de cette tâche.

Configuration requise

En-tête : ppltasks.h

Espace de noms : accès concurrentiel

Voir aussi

Référence

task_completion_event, classe