ICorDebug — Interfejs
Udostępnia metody, które umożliwiają deweloperom debugowanie aplikacji w środowisku środowiska uruchomieniowego języka wspólnego (CLR).
Uwaga
Debugowanie w trybie mieszanym (zarządzanym i natywnym) nie jest obsługiwane na platformach innych niż x86 (takich jak IA64 i AMD64).
Metody
Metoda | Opis |
---|---|
CanLaunchOrAttach, metoda | Określa, czy uruchomienie nowego procesu lub dołączenie do danego procesu jest możliwe w kontekście bieżącej konfiguracji maszyny i środowiska uruchomieniowego. |
CreateProcess, metoda | Uruchamia proces i jego podstawowy wątek pod kontrolą debugera. |
DebugActiveProcess, metoda | Dołącza debuger do istniejącego procesu. |
EnumerateProcesses, metoda | Pobiera moduł wyliczający dla procesów, które są debugowane. |
GetProcess — Metoda | Zwraca obiekt "ICorDebugProcess" o podanym identyfikatorze procesu. |
Initialize — Metoda | Inicjuje ICorDebug obiekt. |
SetManagedHandler, metoda | Określa obiekt programu obsługi zdarzeń dla zdarzeń zarządzanych. |
SetUnmanagedHandler, metoda | Określa obiekt programu obsługi zdarzeń dla zdarzeń niezarządzanych. |
Terminate — Metoda |
ICorDebug Kończy obiekt. |
Uwagi
ICorDebug
reprezentuje pętlę przetwarzania zdarzeń dla procesu debugera. Debuger musi czekać na wywołanie zwrotne ICorDebugManagedCallback::ExitProcess ze wszystkich procesów debugowanych przed wydaniem tego interfejsu.
Obiekt ICorDebug
jest obiektem początkowym do kontrolowania całego dalszego debugowania zarządzanego. W .NET Framework w wersjach 1.0 i 1.1 ten obiekt był obiektem utworzonym CoClass
na podstawie modelu COM. W .NET Framework wersji 2.0 ten obiekt nie jest już obiektemCoClass
. Musi zostać utworzona przez funkcję CreateDebuggingInterfaceFromVersion , która jest bardziej świadoma wersji. Ta nowa funkcja tworzenia umożliwia klientom uzyskanie określonej implementacji ICorDebug
programu , która emuluje również określoną wersję interfejsu API debugowania.
Uwaga
Ten interfejs nie obsługuje wywoływanego zdalnie, między maszynami lub między procesami.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: CorDebug.idl, CorDebug.h
Biblioteki: CorGuids.lib
wersje .NET Framework: dostępne od wersji 1.0