CreateDebuggingInterfaceFromVersion 関数

CreateVersionStringFromModule 関数から返される共通言語ランタイム (CLR) バージョン文字列を受け入れ、対応するデバッガー インターフェイス (通常は ICorDebug) を返します。

構文

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

パラメーター

szDebuggeeVersion
[in] CreateVersionStringFromModule 関数によって返される、ターゲット デバッグ対象の CLR のバージョン文字列。

ppCordb
[out]COM オブジェクト (IUnknown) へのポインターへのポインター。 このオブジェクトは、返される前に ICorDebug オブジェクトにキャストされます。

戻り値

S_OK
ppCordb は、ICorDebug インターフェイス インターフェイスを実装する有効なオブジェクトを参照します。

E_INVALIDARG
szDebuggeeVersionまたはppCordbが null です。

CORDBG_E_DEBUG_COMPONENT_MISSING
CLR デバッグに必要なコンポーネントを見つけられない。 ターゲット CoreCLR.dll と同じディレクトリに mscordbi.dll またはmscordaccore.dllが見つかりませんでした。

CORDBG_E_INCOMPATIBLE_PROTOCOL
mscordbi.dll または mscordaccore.dll は、ターゲット CoreCLR.dllと同じバージョンではありません。

E_FAIL (またはその他の E_ リターン コード)
ICorDebug インターフェイスを返すことができません。

注釈

返されるインターフェイスは、ターゲット プロセスで CLR にアタッチし、CLR が実行されているマネージド コードをデバッグするための機能を提供します。

要求事項

プラットフォーム：サポートされている .NET オペレーティング システムを参照してください。

ヘッダー: dbgshim.h

ライブラリ: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

.NET バージョン: .NET Core 2.1 以降で使用可能