Methode ICLRTask::SetTaskIdentifier
Instrueert de Common Language Runtime (CLR) om de opgegeven id-waarde te koppelen aan de taak die wordt vertegenwoordigd door het huidige ICLRTask-exemplaar .
Syntaxis
HRESULT SetTaskIdentifier (
[in] DWORD Asked
);
Parameters
Asked
[in] De unieke id voor de common language-runtime die moet worden gekoppeld aan de taak die wordt vertegenwoordigd door het huidige ICLRTask exemplaar.
Retourwaarde
| HRESULT | Beschrijving |
|---|---|
| S_OK | SetTaskIdentifier is geretourneerd. |
| HOST_E_CLRNOTAVAILABLE | De CLR is niet geladen in een proces of de CLR heeft een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt. |
| HOST_E_TIMEOUT | Er is een time-out opgetreden voor het gesprek. |
| HOST_E_NOT_OWNER | De beller is niet de eigenaar van het slot. |
| HOST_E_ABANDONED | Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of glasvezel op wachtte. |
| E_FAIL | Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE. |
Opmerkingen
De host kan een id koppelen aan een taak om de CLR en de host te integreren in een foutopsporingsomgeving. De id heeft geen betekenis voor de CLR. De CLR geeft deze door aan een foutopsporingsprogrammatoepassing. Het foutopsporingsprogramma kan deze id gebruiken om een CLR-aanroepstack te koppelen aan een hostaanroepstack en ervoor te zorgen dat hun respectieve traceringsgegevens worden geïntegreerd wanneer deze worden weergegeven in de gebruikersinterface van het foutopsporingsprogramma.
Vereisten
Platforms: Zie Systeemvereisten.
Header: MSCorEE.h
Bibliotheek: Opgenomen als een resource in MSCorEE.dll
.NET Framework versies: beschikbaar sinds 2.0
