CreateDebuggingInterfaceFromVersion3 関数

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

構文

HRESULT CreateDebuggingInterfaceFromVersion3 (
    [in] int iDebuggerVersion,
    [in] LPCWSTR szDebuggeeVersion,
    [in] LPCWSTR szApplicationGroupId,
    [in] ICLRDebuggingLibraryProvider3* pLibraryProvider,
    [out] IUnknown** ppCordb,
);

パラメーター

iDebuggerVersion
[in]デバッガーが想定するインターフェイスのバージョン。

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

szApplicationGroupId
[in]macOS で実行されているサンドボックス プロセスのアプリケーション グループ ID を表す文字列。 プロセスが macOS または他のプラットフォーム上のサンドボックスで実行されていない場合は NULL を渡します。

pLibraryProvider
[in]DBI と DAC を検索するためのコールバック インターフェイス インスタンス。 ICLRDebuggingLibraryProvider3 インターフェイスを参照してください。

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 6.0 以降で使用可能