CreateDebuggingInterfaceFromVersion 関数 (.NET Framework)

  • [アーティクル]

指定したバージョン情報に基づいて ICorDebug オブジェクトを作成します。

.NET Framework 4 ではこの関数が廃止されています。 代わりに、共通言語ランタイム (CLR) 2.0 のインターフェイスを取得するには、ICLRRuntimeInfo::GetInterface メソッドを使用して、クラス識別子 CLSID_CLRDebuggingLegacy とインターフェイス識別子 IID_ICorDebug を指定します。 CLR 4 以降のインターフェイスを取得するには、CLRCreateInstance 関数を呼び出し、クラス識別子 CLSID_CLRDebugging とインターフェイス識別子 IID_ICLRDebugging を指定します。

構文

HRESULT CreateDebuggingInterfaceFromVersion (
    [in]  int      iDebuggerVersion,
    [in]  LPCWSTR  szDebuggeeVersion,
    [out] IUnknown **ppCordb
);

パラメーター

iDebuggerVersion
[in] デバッガーによって想定されている ICorDebug のバージョン。 有効な値については、CorDebugInterfaceVersion 列挙型を参照してください。

szDebuggeeVersion
[in] デバッグ対象のアプリケーションまたはプロセスに関連付けられている共通言語ランタイムのバージョン。 この値を取得する方法については、GetVersionFromProcess または GetRequestedRuntimeVersion メソッドを参照してください。

ppCordb
[out] ICorDebug オブジェクトへのポインターを受け取る場所。

戻り値

このメソッドでは、WinError.h ファイルで定義されているように、次の値に加えて標準の COM エラー コードが返されます。

リターン コード 説明
S_OK メソッドは正常に完了しました。
E_INVALIDARG szDebuggeeVersion または ppCordb が null であるか、バージョン文字列が正しくありません。

解説

szDebuggeeVersion パラメーターは、対応するバージョンの MSCorDbi.dll にマップされます。

必要条件

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

ヘッダー: MSCorEE.h

ライブラリ: MSCorEE.dll

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

関連項目