IHostTask Interface

Provides methods that allow the common language runtime (CLR) to communicate with the host to manage tasks.

interface IHostTask : IUnknown {
    HRESULT Alert ();
    HRESULT GetPriority (
        [out] int *pPriority
    );
    HRESULT Join (
        [in] DWORD dwMilliseconds,
        [in] DWORD option
    ); 
    HRESULT SetCLRTask (
        [in] ICLRTask *pCLRTask
    );
    HRESULT SetPriority (
        [in] int newPriority
    ); 
    HRESULT Start ();
};

Methods

Method Description

IHostTask::Alert Method

Requests that the host wake the task represented by the current IHostTask instance, so the task can be aborted.

IHostTask::GetPriority Method

Gets the thread priority level of the task represented by the current IHostTask instance.

IHostTask::Join Method

Blocks the calling task until the task represented by the current IHostTask instance completes, the specified time interval elapses, or IHostTask::Alert Method is called.

IHostTask::SetCLRTask Method

Associates an ICLRTask Interface instance with the current IHostTask instance.

IHostTask::SetPriority Method

Requests that the host adjust the thread priority level for the task represented by the current IHostTask instance.

IHostTask::Start Method

Requests that the host move the task represented by the current IHostTask instance from a suspended state to a live state, in which code can be executed.

Remarks

The CLR calls methods defined by IHostTask to start a task, set its thread priority level, and so on.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: MSCorEE.idl

Library: Included as a resource in MSCorEE.dll

.NET Framework Version: 2.0

See Also

Reference

ICLRTask Interface
ICLRTaskManager Interface
IHostTaskManager Interface

Other Resources

Hosting Interfaces