IHostThreadPoolManager::QueueUserWorkItem (Método)

Artículo
08/10/2011

Pone en la cola una función para su ejecución y especifica un objeto que contiene los datos que va a utilizar dicha función. La función se ejecutará cuando haya un subproceso disponible.

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

Parámetros

Function
[in] Puntero a función que representa la función que se va a ejecutar.
Context
[in] Objeto que contiene los datos que va a utilizar Function.
Flags
[in] Uno de los valores de marcador, tal como se define para el método QueueUserWorkItem de Win32, que controlan la ejecución.

Valor devuelto

HRESULT	Descripción
S_OK	QueueUserWorkItem finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el 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 llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.

Comentarios

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