Partilhar via

IHostThreadPoolManager::Método QueueUserWorkItem

Coloca uma função em fila para execução e especifica um objeto contendo dados a serem usados por essa função. A função é executada quando um thread fica disponível.

Sintaxe

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

Parâmetros

Function [dentro] Um ponteiro de função que representa a função a executar.

Context [dentro] Um objeto que contém dados a serem usados por Function.

Flags [dentro] Um dos valores de flags, conforme definido para o método Win32 QueueUserWorkItem , controla a execução.

Valor de retorno

HRESULT Descrição
S_OK QueueUserWorkItem regressou com sucesso.
HOST_E_CLRNOTAVAILABLE O tempo de execução da linguagem comum (CLR) não foi carregado num processo, ou o CLR está num estado em que não consegue executar código gerido nem processar a chamada com sucesso.
HOST_E_TIMEOUT A chamada expirou.
HOST_E_NOT_OWNER O chamador não é dono da fechadura.
HOST_E_ABANDONED Um evento foi cancelado enquanto um fio ou fibra bloqueada estava à espera.
E_FAIL Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR deixa de ser utilizado dentro do processo. As chamadas subsequentes para sistemas de alojamento regressam HOST_E_CLRNOTAVAILABLE.

Observações

QueueUserWorkItem coloca um item de trabalho em fila para um thread de trabalho no pool de threads. Os seus tipos de assinatura e parâmetros são idênticos aos da função Win32 correspondente, que tem o mesmo nome. Para mais informações, consulte a documentação da Plataforma Windows.

Requisitos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como recurso em MSCorEE.dll

Versões do .NET Framework: Disponível desde: 2.0

Consulte também

  • Last updated on