ICLRTask::SetTaskIdentifier — Metoda
Nakazuje środowisku uruchomieniowemu języka wspólnego (CLR) skojarzenie określonej wartości identyfikatora z zadaniem reprezentowanym przez bieżące wystąpienie ICLRTask .
Składnia
HRESULT SetTaskIdentifier (
[in] DWORD Asked
);
Parametry
Asked
[in] Unikatowy identyfikator środowiska uruchomieniowego języka wspólnego do skojarzenia z zadaniem reprezentowanym przez bieżące ICLRTask wystąpienie.
Wartość zwracana
| HRESULT | Opis |
|---|---|
| S_OK | SetTaskIdentifier zwrócone pomyślnie. |
| HOST_E_CLRNOTAVAILABLE | ClR nie został załadowany do procesu lub CLR jest w stanie, w którym nie może uruchomić zarządzanego kodu lub przetworzyć wywołania pomyślnie. |
| HOST_E_TIMEOUT | Upłynął limit czasu wywołania. |
| HOST_E_NOT_OWNER | Obiekt wywołujący nie jest właścicielem blokady. |
| HOST_E_ABANDONED | Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie. |
| E_FAIL | Wystąpił nieznany katastrofalny błąd. Gdy metoda zwraca E_FAIL, clR nie będzie już można jej używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE. |
Uwagi
Host może skojarzyć identyfikator z zadaniem, aby ułatwić integrację środowiska CLR i hosta w środowisku debugowania. Identyfikator nie ma znaczenia dla środowiska CLR. ClR przekazuje go do aplikacji debugera. Debuger może użyć tego identyfikatora do skojarzenia stosu wywołań CLR ze stosem wywołań hosta i umożliwić ujednoliconie odpowiednich informacji śledzenia podczas wyświetlania w interfejsie użytkownika debugera.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
Biblioteki: Uwzględnione jako zasób w MSCorEE.dll
wersje .NET Framework: dostępne od wersji 2.0
