Metodo ICLRTask::SetTaskIdentifier

Articolo
08/11/2011

Indica a Common Language Runtime (CLR) di associare il valore dell'identificatore specificato all'attività rappresentata dall'istanza corrente di ICLRTask.

HRESULT SetTaskIdentifier (
    [in] DWORD Asked
);

Parametri

Asked
[in] Identificatore univoco che Common Language Runtime deve associare all'attività rappresentata dall'istanza corrente di ICLRTask.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	SetTaskIdentifier 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 chiamate successive ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

Note

L'host può associare un identificatore a un'attività per consentire l'integrazione di Common Language Runtime (CLR) e dell'host in un ambiente di debug. L'identificatore non ha significato per CLR. CLR lo passa insieme a un'applicazione debugger. Il debugger può utilizzare l'identificatore per associare uno stack di chiamate di CLR a uno stack di chiamate dell'host, consentendo così l'unificazione delle rispettive informazioni di traccia durante la visualizzazione nell'interfaccia utente del debugger.