Condividi tramite


Metodo IHostThreadPoolManager::QueueUserWorkItem

Accoda una funzione per l'esecuzione e specifica un oggetto contenente i dati da utilizzare da tale funzione. La funzione viene eseguita quando un thread diventa disponibile.

Sintassi

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 dati da utilizzare da Function.

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

Valore restituito

HRESULT Descrizione
S_OK QueueUserWorkItem restituito correttamente.
HOST_E_CLRNOTAVAILABLE Common Language Runtime (CLR) non è stato caricato in un processo oppure CLR è in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata.
HOST_E_TIMEOUT Timeout della chiamata.
HOST_E_NOT_OWNER Il chiamante non possiede il blocco.
HOST_E_ABANDONED Un evento è stato annullato mentre un thread bloccato o una fibra era in attesa su di esso.
E_FAIL Si è verificato un errore irreversibile sconosciuto. Quando un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE.

Osservazioni:

QueueUserWorkItem accoda un elemento di lavoro a un thread di lavoro nel pool di thread. I tipi di firma e di parametro sono identici a quelli della funzione Win32 corrispondente, con lo stesso nome. Per altre informazioni, vedere la documentazione della piattaforma Windows.

Requisiti

Piattaforme: Vedere Requisiti di sistema.

Intestazione: MSCorEE.h

Biblioteca: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 2.0

Vedere anche