Compartir a través de

IHostThreadPoolManager::QueueUserWorkItem (Método)

  • Artículo

Pone una función en cola para su ejecución y especifica un objeto que contiene los datos que debe usar la función. La función se ejecuta cuando hay disponible un subproceso.

Sintaxis

HRESULT QueueUserWorkItem (  
    [in] LPTHREAD_START_ROUTINE Function,  
    [in] PVOID Context,  
    [in] ULONG Flags  
);

Parámetros

Function
[in] Puntero de función que representa la función que se va a ejecutar.

Context
[in] Objeto que contiene los datos que va a usar Function.

Flags
[in] Uno de los valores de marcas, tal como se define para el método QueueUserWorkItem de Win32, que controla la ejecución.

Valor devuelto

HRESULT Descripción
S_OK QueueUserWorkItem 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.

Comentarios

QueueUserWorkItem pone en cola un elemento de trabajo en un subproceso de trabajo del grupo de subprocesos. Sus tipos de parámetro y firma son idénticos a los de la función de Win32 correspondiente, que tiene el mismo nombre. Para obtener más información, vea la documentación de la Plataforma de Windows.

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