Partager via


is_task_cancellation_requested, fonction

Retourne une indication du fait que la tâche en cours d'exécution a reçu une demande d'annulation de son exécution. L'annulation est demandée sur une tâche si la tâche a été créée avec un jeton d'annulation, et que la source de jeton associée à ce jeton est annulée.

inline bool __cdecl is_task_cancellation_requested();

Valeur de retour

true si la tâche en cours d'exécution a reçu une demande d'annulation ; sinon, false.

Notes

Si vous appelez cette méthode dans le corps d'une tâche et qu'elle retourne true, vous devez répondre à un appel de cancel_current_task pour accepter la demande d'annulation, après avoir exécuté le nettoyage requis. Cela annulera l'exécution de la tâche et provoquera l'activation de l'état canceled. Si vous ne répondez pas et que vous poursuivez l'exécution ou effectuez un retour au lieu d'appeler cancel_current_task, la tâche accède à l'état completed lorsqu'elle est effectuée.

Une tâche n'est pas annulable si elle a été créée sans jeton d'annulation.

Configuration requise

En-tête : ppltasks.h

Espace de noms : concurrency

Voir aussi

Référence

concurrency, espace de noms

task, classe

cancellation_token_source, classe

cancellation_token, classe

cancel_current_task, fonction