Método IHostThreadPoolManager::QueueUserWorkItem
Enfileira uma função para execução e especifica um objeto que contém dados a serem usados pela função. A função é executado quando um thread se torna disponível.
Sintaxe
HRESULT QueueUserWorkItem (
[in] LPTHREAD_START_ROUTINE Function,
[in] PVOID Context,
[in] ULONG Flags
);
Parâmetros
Function
[in] Um ponteiro de função que representa a função a ser executada.
Context
[in] Um objeto que contém dados a serem usados pela Function
.
Flags
[in] Um dos valores de sinalizadores, conforme definido para o método QueueUserWorkItem
do Win32, que controla a execução.
Valor Retornado
HRESULT | Descrição |
---|---|
S_OK | QueueUserWorkItem retornado com êxito. |
HOST_E_CLRNOTAVAILABLE | O CLR (Common Language Runtime) não foi carregado em um processo ou está em um estado no qual não pode executar o código gerenciado ou processar a chamada com sucesso. |
HOST_E_TIMEOUT | Uma chamada atingiu o tempo limite. |
HOST_E_NOT_OWNER | O chamador não possui o bloqueio. |
HOST_E_ABANDONED | Um evento foi cancelado enquanto uma fibra ou um thread bloqueado estava esperando por ele. |
E_FAIL | Uma falha catastrófica desconhecida ocorreu. Quando um método retorna E_FAIL, o CLR não pode mais ser usado no processo. Chamadas subsequentes para métodos de hospedagem retornam HOST_E_CLRNOTAVAILABLE. |
Comentários
QueueUserWorkItem
enfileira um item de trabalho para um thread de trabalho no pool de threads. Seus tipos de assinatura e parâmetro são idênticos aos da função do Win32 correspondente, que tem o mesmo nome. Para obter mais informações, confira a documentação da plataforma Windows.
Requisitos
Plataformas: confira Requisitos do sistema.
Cabeçalho: MSCorEE.h
Biblioteca: incluída como um recurso no MSCorEE.dll
Versões do .NET Framework: disponíveis desde 2.0