Compartilhar via


Função is_task_cancellation_requested

Retorna uma indicação se a tarefa que está sendo executada atualmente recebeu uma solicitação para cancelar a execução. O cancelamento é solicitado em uma tarefa se a tarefa foi criada com um token de cancelamento, e a fonte do token associada com esse token for cancelada.

inline bool __cdecl is_task_cancellation_requested();

Valor de retorno

true se a tarefa que está sendo executada atualmente tiver recebido uma solicitação para cancelamento, caso contrário, false.

Comentários

Se você chamar esse método no corpo de uma tarefa e ele retornar true, você deverá responder com uma chamada a cancel_current_task para reconhecer a solicitação de cancelamento depois de executar qualquer limpeza necessária. Isso anulará a execução da tarefa e fará com que ela entre no estado de canceled. Se você não responder e continuar com a execução, ou se retornar em vez de chamar cancel_current_task, a tarefa entrará no estado completed quando estiver concluída. estado.

Uma tarefa não pode ser cancelada se foi criada sem um token de cancelamento.

Requisitos

Cabeçalho: ppltasks.h

Namespace: simultaneidade

Consulte também

Referência

Namespace Concurrency

Classe task

Classe cancellation_token_source

Classe cancellation_token

Função cancel_current_task