Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection > Struct Template Reference

The task handle type used to create a 'continuation task'. More...

Inheritance diagram for Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >:

Public Types
typedef details::_NormalizeVoidToUnitType< _ContinuationReturnType >::_Type	_NormalizedContinuationReturnType

Public Member Functions
	_ContinuationTaskHandle (const typename details::_Task_ptr< _ReturnType >::_Type &_AncestorImpl, const typename details::_Task_ptr< _NormalizedContinuationReturnType >::_Type &_ContinuationImpl, const _Function &_Func, const task_continuation_context &_Context, details::_TaskInliningMode_t _InliningMode)
virtual	~_ContinuationTaskHandle ()
template<typename _Func , typename _Arg >
auto	_LogWorkItemAndInvokeUserLambda (_Func &&_func, _Arg &&_value) const -> decltype(_func(std::forward< _Arg >(_value)))
void	_Perform () const
void	_SyncCancelAndPropagateException () const
void	_Continue (std::false_type, details::_TypeSelectorNoAsync) const
void	_Continue (std::false_type, details::_TypeSelectorAsyncOperationOrTask) const
void	_Continue (std::true_type, details::_TypeSelectorNoAsync) const
void	_Continue (std::true_type, details::_TypeSelectorAsyncOperationOrTask) const
Public Member Functions inherited from Concurrency::details::_PPLTaskHandle< details::_NormalizeVoidToUnitType< _ContinuationReturnType >::_Type, _ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >, details::_ContinuationTaskHandleBase >
	_PPLTaskHandle (const typename _Task_ptr< details::_NormalizeVoidToUnitType< _ContinuationReturnType >::_Type >::_Type &_PTask)
virtual	~_PPLTaskHandle ()
virtual void	invoke () const
_Task_ptr_base	_GetTaskImplBase () const
Public Member Functions inherited from Concurrency::details::_ContinuationTaskHandleBase
	_ContinuationTaskHandleBase ()
virtual	~_ContinuationTaskHandleBase ()
Public Member Functions inherited from Concurrency::details::_TaskProcHandle
	_TaskProcHandle ()
virtual	~_TaskProcHandle ()
void	operator() () const
Public Member Functions inherited from Concurrency::details::_UnrealizedChore
	_UnrealizedChore ()
virtual	~_UnrealizedChore ()
void	_Invoke ()
void	_SetDetached (bool _FDetached)
Concurrency::details::_TaskCollectionBase *	_OwningCollection () const
void	_SetRuntimeOwnsLifetime (bool fValue)
bool	_GetRuntimeOwnsLifetime () const
void	_PrepareSteal (ContextBase *_PContext)
Public Member Functions inherited from Concurrency::details::_AllocBase
void *	operator new (size_t _Size)
void	operator delete (void *_Ptr) throw ()
void *	operator new (size_t _Size, const std::nothrow_t &) throw ()
void	operator delete (void *_Ptr, const std::nothrow_t &) throw ()
void *	operator new[] (size_t _Size)
void	operator delete[] (void *_Ptr) throw ()
void *	operator new[] (size_t _Size, const std::nothrow_t &_No_throw) throw ()
void	operator delete[] (void *_Ptr, const std::nothrow_t &_No_throw) throw ()
void *	operator new (size_t, void *_Location) throw ()
void	operator delete (void *, void *) throw ()
void *__cdecl	operator new[] (size_t, void *_Location) throw ()
void __cdecl	operator delete[] (void *, void *) throw ()

Public Attributes
details::_Task_ptr< _ReturnType >::_Type	_M_ancestorTaskImpl
_Function	_M_function
Public Attributes inherited from Concurrency::details::_PPLTaskHandle< details::_NormalizeVoidToUnitType< _ContinuationReturnType >::_Type, _ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >, details::_ContinuationTaskHandleBase >
_Task_ptr< details::_NormalizeVoidToUnitType< _ContinuationReturnType >::_Type >::_Type	_M_pTask
Public Attributes inherited from Concurrency::details::_ContinuationTaskHandleBase
_ContinuationTaskHandleBase *	_M_next
task_continuation_context	_M_continuationContext
bool	_M_isTaskBasedContinuation
_TaskInliningMode_t	_M_inliningMode
Public Attributes inherited from Concurrency::details::_Chore
TaskProc	m_pFunction

Additional Inherited Members
Static Public Member Functions inherited from Concurrency::details::_TaskProcHandle
static void __cdecl	_RunChoreBridge (void *_Parameter)
Static Public Member Functions inherited from Concurrency::details::_UnrealizedChore
template<typename _ChoreType , typename _Function >
static _ChoreType *	_InternalAlloc (const _Function &_Func)
Protected Member Functions inherited from Concurrency::details::_UnrealizedChore
_CRTIMP void	_CheckTaskCollection ()
Protected Member Functions inherited from Concurrency::details::_Chore
	_Chore (TaskProc _PFunction)
	_Chore ()
virtual	~_Chore ()
Static Protected Member Functions inherited from Concurrency::details::_UnrealizedChore
template<typename _ChoreType >
static void __cdecl	_InvokeBridge (void *_PContext)

Detailed Description

template<typename _ReturnType>
template<typename _InternalReturnType, typename _ContinuationReturnType, typename _Function, typename _IsTaskBased, typename _TypeSelection>
struct Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >

The task handle type used to create a 'continuation task'.

Member Typedef Documentation

template<typename _ReturnType>

template<typename _InternalReturnType , typename _ContinuationReturnType , typename _Function , typename _IsTaskBased , typename _TypeSelection >

typedef details::_NormalizeVoidToUnitType<_ContinuationReturnType>::_Type Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >::_NormalizedContinuationReturnType

Constructor & Destructor Documentation

template<typename _ReturnType>

template<typename _InternalReturnType , typename _ContinuationReturnType , typename _Function , typename _IsTaskBased , typename _TypeSelection >

Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >::_ContinuationTaskHandle ( const typename details::_Task_ptr< _ReturnType >::_Type &  _AncestorImpl, const typename details::_Task_ptr< _NormalizedContinuationReturnType >::_Type &  _ContinuationImpl, const _Function &  _Func, const task_continuation_context &  _Context, details::_TaskInliningMode_t  _InliningMode  )

inline

                : details::_PPLTaskHandle<typename details::_NormalizeVoidToUnitType<_ContinuationReturnType>::_Type,
                    _ContinuationTaskHandle<_InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection>, details::_ContinuationTaskHandleBase>
                    ::_PPLTaskHandle(_ContinuationImpl)
                , _M_ancestorTaskImpl(_AncestorImpl)
                , _M_function(_Func)
        {
            this->_M_isTaskBasedContinuation = _IsTaskBased::value;
            this->_M_continuationContext = _Context;
            this->_M_continuationContext._Resolve(_AncestorImpl->_IsApartmentAware());
            this->_M_inliningMode = _InliningMode;
        }

template<typename _ReturnType>

template<typename _InternalReturnType , typename _ContinuationReturnType , typename _Function , typename _IsTaskBased , typename _TypeSelection >

virtual Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >::~_ContinuationTaskHandle ( )

inlinevirtual

{}

Member Function Documentation

template<typename _ReturnType>

template<typename _InternalReturnType , typename _ContinuationReturnType , typename _Function , typename _IsTaskBased , typename _TypeSelection >

void Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >::_Continue ( std::false_type  , details::_TypeSelectorNoAsync    ) const

inline

        {
            this->_M_pTask->_FinalizeAndRunContinuations(
                _LogWorkItemAndInvokeUserLambda(_Continuation_func_transformer<_InternalReturnType, _ContinuationReturnType>::_Perform(_M_function), _M_ancestorTaskImpl->_GetResult()));
        }

template<typename _ReturnType>

template<typename _InternalReturnType , typename _ContinuationReturnType , typename _Function , typename _IsTaskBased , typename _TypeSelection >

void Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >::_Continue ( std::false_type  , details::_TypeSelectorAsyncOperationOrTask    ) const

inline

        {
            typedef typename details::_FunctionTypeTraits<_Function, _InternalReturnType>::_FuncRetType _FuncOutputType;

            details::_Task_impl_base::_AsyncInit<_NormalizedContinuationReturnType, _ContinuationReturnType>(
                this->_M_pTask, 
                _LogWorkItemAndInvokeUserLambda(_Continuation_func_transformer<_InternalReturnType, _FuncOutputType>::_Perform(_M_function), _M_ancestorTaskImpl->_GetResult())
            );
        }

template<typename _ReturnType>

template<typename _InternalReturnType , typename _ContinuationReturnType , typename _Function , typename _IsTaskBased , typename _TypeSelection >

void Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >::_Continue ( std::true_type  , details::_TypeSelectorNoAsync    ) const

inline

        {
            typedef task<_InternalReturnType> _FuncInputType;
            task<_InternalReturnType> _ResultTask;
            _ResultTask._SetImpl(std::move(_M_ancestorTaskImpl));
            this->_M_pTask->_FinalizeAndRunContinuations(
                _LogWorkItemAndInvokeUserLambda(_Continuation_func_transformer<_FuncInputType, _ContinuationReturnType>::_Perform(_M_function), std::move(_ResultTask)));
        }

template<typename _ReturnType>

template<typename _InternalReturnType , typename _ContinuationReturnType , typename _Function , typename _IsTaskBased , typename _TypeSelection >

void Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >::_Continue ( std::true_type  , details::_TypeSelectorAsyncOperationOrTask    ) const

inline

        {
            // The continuation takes a parameter of type task<_Input>, which is the same as the ancestor task.
            task<_InternalReturnType> _ResultTask;
            _ResultTask._SetImpl(std::move(_M_ancestorTaskImpl));
            details::_Task_impl_base::_AsyncInit<_NormalizedContinuationReturnType, _ContinuationReturnType>(this->_M_pTask, 
                _LogWorkItemAndInvokeUserLambda(_M_function, std::move(_ResultTask)));
        }

template<typename _ReturnType>

template<typename _InternalReturnType , typename _ContinuationReturnType , typename _Function , typename _IsTaskBased , typename _TypeSelection >

template<typename _Func , typename _Arg >

auto Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >::_LogWorkItemAndInvokeUserLambda ( _Func &&  _func, _Arg &&  _value  ) const -> decltype(_func(std::forward<_Arg>(_value)))

inline

        {
            details::_TaskWorkItemRAIILogger _LogWorkItem(this->_M_pTask->_M_taskEventLogger);
            return _func(std::forward<_Arg>(_value));
        }

template<typename _ReturnType>

template<typename _InternalReturnType , typename _ContinuationReturnType , typename _Function , typename _IsTaskBased , typename _TypeSelection >

void Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >::_Perform ( ) const

inline

        {
            _Continue(_IsTaskBased(), _TypeSelection());
        }

template<typename _ReturnType>

template<typename _InternalReturnType , typename _ContinuationReturnType , typename _Function , typename _IsTaskBased , typename _TypeSelection >

void Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >::_SyncCancelAndPropagateException ( ) const

inline

        {
            if (_M_ancestorTaskImpl->_HasUserException())
            {
                // If the ancestor encountered an exception, transfer the exception to the continuation
                // This traverses down the tree to propagate the exception.
                this->_M_pTask->_CancelWithExceptionHolder(_M_ancestorTaskImpl->_GetExceptionHolder(), true);
            }
            else
            {
                // If the ancestor was canceled, then your own execution should be canceled.
                // This traverses down the tree to cancel it.
                this->_M_pTask->_Cancel(true);
            }
        }

Member Data Documentation

template<typename _ReturnType>

template<typename _InternalReturnType , typename _ContinuationReturnType , typename _Function , typename _IsTaskBased , typename _TypeSelection >

details::_Task_ptr<_ReturnType>::_Type Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >::_M_ancestorTaskImpl

template<typename _ReturnType>

template<typename _InternalReturnType , typename _ContinuationReturnType , typename _Function , typename _IsTaskBased , typename _TypeSelection >

_Function Concurrency::task< _ReturnType >::_ContinuationTaskHandle< _InternalReturnType, _ContinuationReturnType, _Function, _IsTaskBased, _TypeSelection >::_M_function

---

The documentation for this struct was generated from the following file:

• VS2013/inc/ppltasks.h