Condividi tramite


Metodo IHostThreadPoolManager::QueueUserWorkItem

Accoda una funzione per l'esecuzione e specifica un oggetto contenente i dati che devono essere utilizzati dalla funzione. La funzione viene eseguita quando un thread risulta disponibile.

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

Parametri

  • Function
    [in] Puntatore a funzione che rappresenta la funzione da eseguire.

  • Context
    [in] Oggetto che contiene i dati che devono essere utilizzati da Function.

  • Flags
    [in] Uno dei valori dei flag, come definito per il metodo QueueUserWorkItem Win32, che controlla l'esecuzione.

Valore restituito

HRESULT

Oggetto di descrizione

S_OK

QueueUserWorkItem ha restituito correttamente un valore.

HOST_E_CLRNOTAVAILABLE

Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.

HOST_E_TIMEOUT

Timeout della chiamata.

HOST_E_NOT_OWNER

Il chiamante non è il proprietario del blocco.

HOST_E_ABANDONED

Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.

E_FAIL

Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

Note

QueueUserWorkItem accoda un elemento di lavoro a un thread di lavoro nel pool di thread. La firma e tipi di parametro sono identici a quelli della funzione Win32 corrispondente, che ha lo stesso nome. Per ulteriori informazioni, vedere la documentazione relativa alla piattaforma Windows.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vedere anche

Riferimenti

QueueUserWorkItem

ThreadPool

Interfaccia IHostThreadPoolManager