IHostTaskManager

Artículo
10/07/2008

Actualización: noviembre 2007

Proporciona métodos que permiten a Common Language Runtime trabajar con tareas a través del host en lugar de utilizar el subprocesamiento estándar del sistema operativo o las funciones de fibra.

interface IHostTaskManager : IUnknown
{
    HRESULT GetCurrentTask (
                [out] IHostTask **pTask
        );

    HRESULT CreateTask (
                [in] DWORD dwStackSize,
        [in] LPTHREAD_START_ROUTINE pStartAddress,
        [in] PVOID pParameter,
        [out] IHostTask **ppTask
        );

    HRESULT Sleep (
                [in] DWORD dwMilliseconds,
        [in] DWORD option
        );

    HRESULT SwitchToTask (
                [in] DWORD option
        );

    HRESULT SetUILocale (
                [in] LCID lcid
        );

    HRESULT SetLocale (
                [in] LCID lcid
        );

    HRESULT CallNeedsHostHook (
                [in] SIZE_T target,
        [out] BOOL *pbCallNeedsHostHook
        );

    HRESULT LeaveRuntime (
                [in] SIZE_T target
        );

    HRESULT EnterRuntime ();

    HRESULT ReverseLeaveRuntime ();

    HRESULT ReverseEnterRuntime ();

    HRESULT BeginDelayAbort ();

    HRESULT EndDelayAbort ();

    HRESULT BeginThreadAffinity ();

    HRESULT EndThreadAffinity ();

    HRESULT SetStackGuarantee (
                [in] ULONG guarantee
        );

    HRESULT GetStackGuarantee (
                [out] ULONG *pGuarantee
        );

    HRESULT SetCLRTaskManager (
        [in] ICLRTaskManager *ppManager
        );

}

Métodos

Método	Descripción
IHostTaskManager::BeginDelayAbort (Método)	Notifica al host que el código administrado está entrando en un período en el cual no se debe anular la tarea actual.
IHostTaskManager::BeginThreadAffinity (Método)	Notifica al host que el código administrado está entrando en un período en el que la tarea actual no se debe mover a otro subproceso del sistema operativo.
IHostTaskManager::CallNeedsHostHook (Método)	Permite al host especificar si Common Language Runtime puede procesar en línea la llamada especificada a una función no administrada.
IHostTaskManager::CreateTask (Método)	Solicita que el host cree una nueva tarea.
IHostTaskManager::EndDelayAbort (Método)	Notifica al host que el código administrado está saliendo del período en que no se debe anular la tarea actual, después de una llamada anterior a BeginDelayAbort.
IHostTaskManager::EndThreadAffinity (Método)	Notifica al host que el código administrado está saliendo del período en que no se debe mover la tarea actual a otro subproceso del sistema operativo, después de una llamada anterior a BeginThreadAffinity.
IHostTaskManager::EnterRuntime (Método)	Notifica al host que una llamada a un método no administrado, como un método de invocación de plataforma, está devolviendo el control de la ejecución a CLR.
IHostTaskManager::GetCurrentTask (Método)	Obtiene un puntero de interfaz a la tarea que se está ejecutando actualmente en el subproceso del sistema operativo desde el que se realiza la llamada.
IHostTaskManager::GetStackGuarantee (Método)	Obtiene la cantidad de espacio de pila cuya disponibilidad estará garantizada después de que se complete una operación de pila pero antes del cierre de un proceso.
IHostTaskManager::LeaveRuntime (Método)	Notifica al host que el código administrado está a punto de realizar una llamada a una función no administrada.
IHostTaskManager::ReverseEnterRuntime (Método)	Notifica al host que se está realizando una llamada a Common Language Runtime (CLR) desde código no administrado.
IHostTaskManager::ReverseLeaveRuntime (Método)	Notifica al host que el control está abandonando CLR y está entrando en una función no administrada a la que se ha llamado desde el código administrado.
IHostTaskManager::SetCLRTaskManager (Método)	Proporciona al host un puntero de interfaz a una instancia de ICLRTaskManager implementada por CLR.
IHostTaskManager::SetLocale (Método)	Notifica al host que CLR ha modificado la configuración regional de la tarea actual.
IHostTaskManager::SetStackGuarantee (Método)	Reservado sólo para uso interno.
IHostTaskManager::SetUILocale (Método)	Notifica al host que se ha modificado la configuración regional de la interfaz de usuario en la tarea actual.
IHostTaskManager::Sleep (Método)	Notifica al host que la tarea actual va a permanecer inactiva.
IHostTaskManager::SwitchToTask (Método)	Notifica al host que debe cambiar la tarea actual.

Comentarios

IHostTaskManager permite a CLR crear y administrar tareas, proporcionar enlaces para que el host realice las acciones necesarias cuando se transfiera el control del código administrado al no administrado y viceversa, así como especificar las acciones que puede y no puede realizar el host durante la ejecución del código.