IHostTaskManager::CreateTask (Método)

  • Artículo

Solicita que el host cree una tarea.

Sintaxis

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

Parámetros

stacksize
[in] Tamaño solicitado, en bytes, de la pila solicitada, o bien 0 (cero) para el tamaño predeterminado.

pStartAddress
[in] Puntero a la función que va a ejecutar la tarea.

pParameter
[in] Puntero a los datos de usuario que se van a pasar a la función, o bien null si la función no toma ningún parámetro.

ppTask
[out] Puntero a la dirección de una instancia de IHostTask que crea el host, o bien null si no se puede crear la tarea. La tarea permanece en un estado suspendido hasta que se inicia explícitamente mediante una llamada a IHostTask::Start.

Valor devuelto

HRESULT Descripción
S_OK CreateTask se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE El Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER El autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY Si se devuelve este valor, significa que no hubo suficiente memoria disponible para crear la tarea solicitada.

Comentarios

CLR llama a CreateTask para solicitar que el host cree una tarea. El host devuelve un puntero de interfaz a una instancia de IHostTask. La tarea devuelta debe permanecer suspendida hasta que se inicie explícitamente mediante una llamada a IHostTask::Start.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también