ICLRTask::SetTaskIdentifier metódus
Utasítja a közös nyelvi futtatókörnyezetet (CLR), hogy társítsa a megadott azonosítóértéket az aktuális ICLRTask-példány által képviselt feladattal.
Szintaxis
HRESULT SetTaskIdentifier (
[in] DWORD Asked
);
Paraméterek
Asked
[in] Az aktuális ICLRTask
példány által képviselt feladathoz társítandó közös nyelvi futtatókörnyezet egyedi azonosítója.
Visszatérési érték
HRESULT | Description |
---|---|
S_OK | SetTaskIdentifier sikeresen visszaadott. |
HOST_E_CLRNOTAVAILABLE | A CLR nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem tudja futtatni a felügyelt kódot, vagy nem tudja sikeresen feldolgozni a hívást. |
HOST_E_TIMEOUT | A hívás túllépte az időkorlátot. |
HOST_E_NOT_OWNER | A hívó nem rendelkezik a zárral. |
HOST_E_ABANDONED | Egy esemény megszakadt, miközben egy blokkolt szál vagy szál várakozott rá. |
E_FAIL | Ismeretlen katasztrofális hiba történt. Amikor egy metódus E_FAIL ad vissza, a CLR már nem használható a folyamaton belül. Az üzemeltetési módszerekre irányuló későbbi hívások HOST_E_CLRNOTAVAILABLE adnak vissza. |
Megjegyzések
A gazdagép hozzárendelhet egy azonosítót egy feladathoz, amely segít integrálni a CLR-t és a gazdagépet egy hibakeresési környezetben. Az azonosítónak nincs jelentése a CLR-hez. A CLR továbbítja azt egy hibakereső alkalmazásnak. A hibakereső ezt az azonosítót használhatja egy CLR-hívásverem gazdagéphívási veremhez való társításához, és lehetővé teszi a megfelelő nyomkövetési információk egységesítése a hibakereső felhasználói felületén való megtekintéskor.
Követelmények
Platformok: Lásd: Rendszerkövetelmények.
Fejléc: MSCorEE.h
Könyvtár: Erőforrásként szerepel a MSCorEE.dll
.NET-keretrendszer verziók: 2.0 óta érhető el