接受從 CreateVersionStringFromModule 函式傳回的 Common Language Runtime (CLR) 版本字串,並傳回對應的調試程式介面(通常是 ICorDebug)。
語法
HRESULT CreateDebuggingInterfaceFromVersion2 (
[in] int iDebuggerVersion,
[in] LPCWSTR szDebuggeeVersion,
[in] LPCWSTR szApplicationGroupId,
[out] IUnknown** ppCordb,
);
參數
iDebuggerVersion
[in]調試程式預期的介面版本。
szDebuggeeVersion
[in]目標 debuggee 中 CLR 的版本字串,由 CreateVersionStringFromModule 函式傳回。
szApplicationGroupId
[in]字串,表示在macOS中執行的沙箱化進程的應用程式群組標識碼。 如果進程未在macOS上的沙箱或其他平台上執行,則傳遞NULL。
ppCordb
[out]COM 物件指標的指標 (IUnknown)。 在傳回 ICorDebug 物件之前,這個物件會轉換成 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 執行中的 Managed 程式代碼。
需求
平臺: 請參閱 .NET 支援的作系統。
標頭: dbgshim.h
連結庫: dbgshim.dll、libdbgshim.so、libdbgshim.dylib
.NET 版本: 自 .NET Core 3.1 起提供