Comparteix a través de


IHostThreadPoolManager::QueueUserWorkItem (Método)

Pone en cola una función para su ejecución y especifica un objeto que contiene los datos que va a usar esa función. La función se ejecuta cuando un subproceso está disponible.

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 Win32 QueueUserWorkItem , que controla la ejecución.

Valor devuelto

HRESULT Descripción
S_OK QueueUserWorkItem se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE Common Language Runtime (CLR) no se ha cargado en un proceso o CLR está en un estado en el que no puede ejecutar código administrado ni procesar correctamente la llamada.
HOST_E_TIMEOUT Se agota el tiempo de espera de la llamada.
HOST_E_NOT_OWNER El autor de la llamada no posee el bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras un subproceso bloqueado o fibra estaba esperando.
E_FAIL Se produjo un error catastrófico desconocido. Cuando un método devuelve E_FAIL, CLR ya no se puede usar dentro del proceso. Las llamadas posteriores a los métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.

Observaciones

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

Requisitos

Plataformas: Consulte Requisitos del sistema.

Encabezado: MSCorEE.h

Biblioteca: Incluido como recurso en MSCorEE.dll

Versiones de .NET Framework: Disponible desde la versión 2.0

Consulte también