Udostępnij przez

ICLRProfiling::AttachProfiler — Metoda

Dołącza określony profiler do określonego procesu.

Składnia

HRESULT AttachProfiler(  
  [in] DWORD dwProfileeProcessID,  
  [in] DWORD dwMillisecondsMax,                     // optional  
  [in] const CLSID * pClsidProfiler,  
  [in] LPCWSTR wszProfilerPath,                     // optional  
  [in] size_is(cbClientData)] void * pvClientData,  // optional  
  [in] UINT cbClientData);                          // optional

Parametry

dwProfileeProcessID
[in] Identyfikator procesu, do którego należy dołączyć profiler. Na maszynie 64-bitowej bitowość profilowanego procesu musi być zgodna z bitowością procesu wyzwalacza, który wywołuje metodę AttachProfiler. Jeśli konto użytkownika, w ramach którego AttachProfiler jest wywoływane, ma uprawnienia administracyjne, proces docelowy może być dowolnym procesem w systemie. W przeciwnym razie proces docelowy musi być własnością tego samego konta użytkownika.

dwMillisecondsMax
[in] Czas trwania (w milisekundach) do AttachProfiler ukończenia. Proces wyzwalacza powinien przekazać limit czasu, który jest znany jako wystarczający dla określonego profilera w celu ukończenia jego inicjowania.

pClsidProfiler
[in] Wskaźnik do identyfikatora CLSID profilera do załadowania. Proces wyzwalacza może ponownie używać tej pamięci po AttachProfiler powrocie.

wszProfilerPath
[in] Pełna ścieżka do pliku DLL profilera do załadowania. Ten ciąg powinien zawierać nie więcej niż 260 znaków, w tym terminator o wartości null. Jeśli wszProfilerPath parametr ma wartość null lub pusty ciąg, środowisko uruchomieniowe języka wspólnego (CLR) spróbuje znaleźć lokalizację pliku DLL profilera, wyszukując w rejestrze identyfikator CLSID wskazujący pClsidProfiler .

pvClientData
[in] Wskaźnik do danych, które mają zostać przekazane do profilera przez metodę ICorProfilerCallback3::InitializeForAttach . Proces wyzwalacza może ponownie używać tej pamięci po AttachProfiler powrocie. Jeśli pvClientData parametr ma wartość null, cbClientData musi mieć wartość 0 (zero).

cbClientData
[in] Rozmiar w bajtach danych, które pvClientData wskazuje.

Wartość zwracana

Ta metoda zwraca następujące wartości HRESULTs.

HRESULT Opis
S_OK Określony profiler został pomyślnie dołączony do procesu docelowego.
CORPROF_E_PROFILER_ALREADY_ACTIVE Profiler jest już aktywny lub dołączany do procesu docelowego.
CORPROF_E_PROFILER_NOT_ATTACHABLE Określony profiler nie obsługuje załącznika. Proces wyzwalacza może podjąć próbę dołączenia innego profilera.
CORPROF_E_PROFILEE_INCOMPATIBLE_WITH_TRIGGER Nie można zażądać załącznika profilera, ponieważ wersja procesu docelowego jest niezgodna z bieżącym procesem wywołującym metodę AttachProfiler.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) Użytkownik procesu wyzwalacza nie ma dostępu do procesu docelowego.
HRESULT_FROM_WIN32(ERROR_PRIVILEGE_NOT_HELD) Użytkownik procesu wyzwalacza nie ma uprawnień niezbędnych do dołączenia profilera do danego procesu docelowego. Dziennik zdarzeń aplikacji może zawierać więcej informacji.
CORPROF_E_IPC_FAILED Wystąpił błąd podczas komunikowania się z procesem docelowym. Dzieje się tak często, jeśli proces docelowy został zamknięty.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) Proces docelowy nie istnieje lub nie uruchamia środowiska CLR obsługującego załącznik. Może to wskazywać, że clR został zwolniony od wywołania metody wyliczania środowiska uruchomieniowego.
HRESULT_FROM_WIN32(ERROR_TIMEOUT) Upłynął limit czasu bez rozpoczynania ładowania profilera. Możesz ponowić próbę wykonania operacji dołączania. Przekroczenia limitu czasu występują, gdy finalizator w procesie docelowym jest uruchamiany przez dłuższy czas niż wartość limitu czasu.
E_INVALIDARG Co najmniej jeden parametr ma nieprawidłowe wartości.
E_FAIL Wystąpił inny nieokreślony błąd.
Inne kody błędów Jeśli metoda ICorProfilerCallback3::InitializeForAttach profilera zwraca wartość HRESULT wskazującą błąd, AttachProfiler zwraca tę samą wartość HRESULT. W takim przypadku E_NOTIMPL jest konwertowana na CORPROF_E_PROFILER_NOT_ATTACHABLE.

Uwagi

Zarządzanie pamięcią

Zgodnie z konwencjami COM obiekt wywołujący AttachProfiler (na przykład kod wyzwalacza utworzony przez dewelopera profilera) jest odpowiedzialny za przydzielanie i delokowanie pamięci dla danych, do których pvClientData wskazuje parametr. Gdy clR wykonuje AttachProfiler wywołanie, wykonuje kopię pamięci, która pvClientData wskazuje i przekazuje ją do procesu docelowego. Gdy clR wewnątrz procesu docelowego odbiera własną kopię pvClientData bloku, przekazuje blok do profilera za pomocą InitializeForAttach metody , a następnie cofa jego kopię pvClientData bloku z procesu docelowego.

Wymagania

Platformy: Zobacz Wymagania systemowe.

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

Biblioteki: CorGuids.lib

wersje .NET Framework: dostępne od 4

Zobacz też

  • Last updated on