task_completion_event::set_exception 方法

  • 發行項

會傳播到與這個事件相關聯的所有任務的例外狀況。

bool set_exception(
   std::exception_ptr _ExceptionPtr
) const ;

參數

  • _ExceptionPtr
    若要設定與這個事件的例外狀況會指示 exception_ptr。

傳回值

此方法會傳回true如果它已順利設定例外狀況。它會傳回false如果 task_completion_event 已經有一個值或例外狀況。

備註

設定兩個設定，並set_exception可以多次呼叫。當例外狀況或值已設定在task_completion_event，呼叫set_exception就會失敗，且會傳回 false。否則，呼叫成功，則函數會傳回，則為 true。當例外狀況設定已成功在task_completion_event，必須明確地設定例外狀況所觀察到使用者。這可以藉由從所建立的工作上呼叫 get task_completion_event，或藉由呼叫 get 前項以工作為主的接續，該任務的任務。

需求

標頭: ppltasks.h

Namespace: 並行存取

請參閱

參考

task_completion_event 類別