更新 : 2007 年 11 月
ホストがタスク セットを識別子および表示名に関連付けられるようにするメソッドを提供します。
interface ICLRDebugManager: IUnknown {
HRESULT BeginConnection (
[in] CONNID dwConnectionId,
[in, string] wchar_t * szConnectionName
);
HRESULT EndConnection (
[in] CONNID dwConnectionId
);
HRESULT GetDacl (
[out] PACL* ppacl
);
HRESULT IsDebuggerAttached (
[out] BOOL *pbAttached
);
HRESULT SetConnectionTasks (
[in] CONNID id,
[in] DWORD dwCount,
[in, size_is(dwCount)] ICLRTask **ppCLRTask
);
HRESULT SetDacl (
[in] PACL pacl
);
HRESULT SetSymbolReadingPolicy (
[in] ESymbolReadingPolicy policy
);
};
メソッド
メソッド |
説明 |
|---|---|
ホストとデバッガの間に新しい接続を確立して、タスクを識別子と表示名に関連付けます。 |
|
タスクの一覧と識別子および表示名との関連付けを削除します。 |
|
このメソッドは実装されていません。 |
|
デバッガがプロセスにアタッチされているかどうかを示す値を取得します。 |
|
ICLRTask インスタンスの一覧を、識別子および表示名に関連付けます。 |
|
このメソッドは実装されていません。 |
|
プログラム データベース (PDB: program database) ファイルの読み取りのポリシーを設定します。ポリシーは、行番号とファイルに関する情報が呼び出し履歴に含まれているかどうかを判断します。 |
解説
デバッグを行う場合、ホストはプログラミング ロジックごとにタスクをグループ化する場合があります。たとえば、開発者にはプロセス内で実行しているすべてのタスクを表示するのではなく、開発者の API に必要なタスクだけを表示するようにできます。ICLRDebugManager は、ホストがこのようなグループ化を実装できるようにします。
.gif "重要 :") 重要 : |
|---|
ICLRDebugManager の 3 つのメソッド、BeginConnection、SetConnectionTasks、および EndConnection は、互いに依存関係にあります。これらが予測どおりに動作するためには、一定の順序で呼び出すことが必要です。 |
ホストによるタスクのグループ化と、ホストが各グループに割り当てる識別子と表示名は、共通言語ランタイム (CLR: Common Language Runtime) にとっては意味を持ちません。CLR はその情報をデバッガに渡すだけです。
必要条件
プラットフォーム : 「.NET Framework システム要件」を参照
ヘッダー : MSCorEE.idl
ライブラリ : MSCorEE.dll にリソースとして格納されていること
.NET Framework のバージョン : 3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0