Metodo IHostThreadPoolManager::QueueUserWorkItem

Articolo
08/11/2011

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.