Udostępnij przez

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

Zobacz też

  • Last updated on