Udostępnij za pośrednictwem


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 ICorDebugprogramu , 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

Zobacz też