Udostępnij za pośrednictwem

ICorProfilerInfo3::RequestProfilerDetach — Metoda

  • Artykuł

Instruuje środowisko uruchomieniowe, aby odłączyło profilera.

Składnia

HRESULT RequestProfilerDetach(
   [in] DWORD    dwExpectedCompletionMilliseconds);

Parametry

dwExpectedCompletionMilliseconds [in] Czas w milisekundach środowisko uruchomieniowe języka wspólnego (CLR) powinno czekać przed sprawdzeniem, czy profiler jest bezpieczny.

Wartość zwracana

Ta metoda zwraca następujące określone elementy HRESULTs, a także błędy HRESULT wskazujące niepowodzenie metody.

HRESULT opis
S_OK Żądanie odłączenia jest prawidłowe, a procedura odłączania jest teraz kontynuowana w innym wątku. Po pełnym zakończeniu ProfilerDetachSucceeded odłączania jest wystawiane zdarzenie.
E_CORPROF_E_CALLBACK3_REQUIRED Profiler zakończył się niepowodzeniem próby IUnknown::QueryInterface dla interfejsu ICorProfilerCallback3 , który musi zaimplementować w celu obsługi operacji odłączania. Nie podjęto próby odłączenia.
CORPROF_E_IMMUTABLE_FLAGS_SET Odłączanie jest niemożliwe, ponieważ profiler ustawia niezmienne flagi podczas uruchamiania. Nie podjęto próby odłączenia; profiler jest nadal w pełni dołączony.
CORPROF_E_IRREVERSIBLE_INSTRUMENTATION_PRESENT Odłączanie jest niemożliwe, ponieważ profiler używał instrumentowanego kodu wspólnego języka pośredniego (CIL) lub wstawionych enter/leave punktów zaczepienia. Nie podjęto próby odłączenia; profiler jest nadal w pełni dołączony.

Uwaga Instrumentowany kod CIL jest kodem dostarczanym przez profilera przy użyciu metody SetILFunctionBody .
CORPROF_E_RUNTIME_UNINITIALIZED Środowisko uruchomieniowe nie zostało jeszcze zainicjowane w aplikacji zarządzanej. (Oznacza to, że środowisko uruchomieniowe nie zostało w pełni załadowane). Ten kod błędu może zostać zwrócony, gdy zażądano odłączenia wewnątrz metody ICorProfilerCallback wywołania zwrotnego profilera::Initialize .
CORPROF_E_UNSUPPORTED_CALL_SEQUENCE RequestProfilerDetach został wywołany w nieobsługiwanym czasie. Dzieje się tak, jeśli metoda jest wywoływana w zarządzanym wątku, ale nie z metody ICorProfilerCallback lub z metody ICorProfilerCallback , która nie może tolerować odzyskiwania pamięci. Aby uzyskać więcej informacji, zobacz CORPROF_E_UNSUPPORTED_CALL_SEQUENCE HRESULT.

Uwagi

Podczas procedury odłączania wątek odłączania (wątek utworzony specjalnie do odłączania profilera) od czasu do czasu sprawdza, czy wszystkie wątki zakończyły kod profilera. Profiler powinien dostarczyć oszacowanie, jak długo powinno to potrwać przez dwExpectedCompletionMilliseconds parametr . Dobrą wartością do użycia jest typowa ilość czasu spędzanego przez profilera wewnątrz danej ICorProfilerCallback* metody. Ta wartość nie powinna być mniejsza niż połowa maksymalnego czasu, jaki profiler spodziewa się spędzić.

Wątek odłączania używa dwExpectedCompletionMilliseconds metody , aby zdecydować, jak długo należy spać przed sprawdzeniem, czy kod wywołania zwrotnego profilera został pominięty we wszystkich stosach. Chociaż szczegóły poniższego algorytmu mogą ulec zmianie w przyszłych wersjach środowiska CLR, ilustruje jeden ze sposobów dwExpectedCompletionMilliseconds określania, kiedy można bezpiecznie zwolnić profilera. Wątek odłączania najpierw śpi w dwExpectedCompletionMilliseconds milisekundach. Jeśli po przebudzeniu ze snu CLR wykryje, że kod wywołania zwrotnego profilera jest nadal obecny, odłączanie wątku ponownie śpi, tym razem przez dwa dwExpectedCompletionMilliseconds milisekundy. Jeśli po przebudzeniu z tego drugiego uśpienia, wątek odłączenia wykryje, że kod wywołania zwrotnego profilera jest nadal obecny, spa przez 10 minut przed ponownym sprawdzeniem. Wątek odłączania kontynuuje ponowne sprawdzanie co 10 minut.

Jeśli profiler określa dwExpectedCompletionMilliseconds wartość 0 (zero), clR używa wartości domyślnej 5000, co oznacza, że wykona kontrolę po 5 sekundach, ponownie po 10 sekundach, a następnie co 10 minut później.

Wymagania

Platformy: zobacz Wymagania systemowe.

Nagłówek: CorProf.idl, CorProf.h

Biblioteka: CorGuids.lib

Wersje programu .NET Framework: dostępne od 4

Zobacz też