Edit

IHostTaskManager Interface

  • Article

Provides methods that allow the common language runtime (CLR) to work with tasks through the host instead of using the standard operating system threading or fiber functions.

Methods

Method Description
BeginDelayAbort Method Notifies the host that managed code is entering a period in which the current task must not be aborted.
BeginThreadAffinity Method Notifies the host that managed code is entering a period in which the current task must not be moved to another operating system thread.
CallNeedsHostHook Method Enables the host to specify whether the common language runtime can inline the specified call to an unmanaged function.
CreateTask Method Requests that the host create a new task.
EndDelayAbort Method Notifies the host that managed code is exiting the period in which the current task must not be aborted, following an earlier call to BeginDelayAbort.
EndThreadAffinity Method Notifies the host that managed code is exiting the period in which the current task must not be moved to another operating system thread, following an earlier call to BeginThreadAffinity.
EnterRuntime Method Notifies the host that a call to an unmanaged method, such as a platform invoke method, is returning execution control to the CLR.
GetCurrentTask Method Gets an interface pointer to the task that is currently executing on the operating system thread from which this call is made.
GetStackGuarantee Method Gets the amount of stack space that is guaranteed to be available after a stack operation completes, but before the closing of a process.
LeaveRuntime Method Notifies the host that managed code is about to make a call to an unmanaged function.
ReverseEnterRuntime Method Notifies the host that a call is being made into the common language runtime (CLR) from unmanaged code.
ReverseLeaveRuntime Method Notifies the host that control is leaving the CLR and entering an unmanaged function that was, in turn, called from managed code.
SetCLRTaskManager Method Provides the host with an interface pointer to an ICLRTaskManager instance implemented by the CLR.
SetLocale Method Notifies the host that the CLR has changed the locale on the current task.
SetStackGuarantee Method Reserved for internal use only.
SetUILocale Method Notifies the host that the user interface locale has been changed on the current task.
Sleep Method Notifies the host that the current task is going to sleep.
SwitchToTask Method Notifies the host that it should switch out the current task.

Remarks

IHostTaskManager allows the CLR to create and manage tasks, to provide hooks for the host to take action when control transfers from managed to unmanaged code and vice versa, and to specify certain actions the host can and cannot take during code execution.

Requirements

Platforms: See System Requirements.

Header: MSCorEE.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Versions: Available since 2.0

See also