ICorDebug インターフェイス

  • [アーティクル]

開発者が共通言語ランタイム (CLR) 環境でアプリケーションをデバッグできるようにするメソッドを提供します。

Note

x86 以外のプラットフォーム (IA64、AMD64 など) では、混合モード (マネージドとネイティブ コード) デバッグはサポートされていません。

メソッド

メソッド 説明
CanLaunchOrAttach メソッド 現在のマシンおよびランタイム構成のコンテキスト内で、新しいプロセスの起動または指定されたプロセスへのアタッチが可能かを判断します。
CreateProcess メソッド デバッガーの制御下でプロセスとそのプライマリ スレッドを起動します。
DebugActiveProcess メソッド デバッガーを既存のプロセスにアタッチします。
EnumerateProcesses メソッド デバッグされているプロセスの列挙子を取得します。
GetProcess メソッド 指定されたプロセス ID を持つ "ICorDebugProcess" オブジェクトを返します。
Initialize メソッド ICorDebug オブジェクトを初期化します。
SetManagedHandler メソッド マネージド イベントのイベント ハンドラー オブジェクトを指定します。
SetUnmanagedHandler メソッド アンマネージド イベントのイベント ハンドラー オブジェクトを指定します。
Terminate メソッド ICorDebug オブジェクトを終了します。

解説

ICorDebug は、デバッガー プロセスのイベント処理ループを表します。 デバッガーは、このインターフェイスを解放する前に、デバッグされているすべてのプロセスからの ICorDebugManagedCallback::ExitProcess コールバックを待機する必要があります。

ICorDebug オブジェクトは、さらに管理されているすべてのデバッグを制御するための初期オブジェクトです。 .NET Framework バージョン 1.0 および 1.1 では、このオブジェクトは COM から作成された CoClass オブジェクトでした。 .NET Framework バージョン 2.0 では、このオブジェクトは CoClass オブジェクトではなくなりました。 これは、よりバージョンを認識する CreateDebuggingInterfaceFromVersion 関数によって作成される必要があります。 この新しい作成関数を使用すると、クライアントは ICorDebug の特定の実装を取得できます。これは、特定のバージョンのデバッグ API もエミュレートします。

Note

このインターフェイスは、コンピューター間またはプロセス間でのリモート呼び出しをサポートしていません。

必要条件

:「システム要件」を参照してください。

ヘッダー: CorDebug.idl、CorDebug.h

ライブラリ: CorGuids.lib

.NET Framework のバージョン: 1.0 以降で使用可能

関連項目