CreateDebuggingInterfaceFromVersion3 函式

接受從 CreateVersionStringFromModule 函式傳回的 Common Language Runtime （CLR） 版本字串，並傳回對應的調試程式介面（通常是 ICorDebug）。

語法

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

參數

iDebuggerVersion
[in]調試程式預期的介面版本。

szDebuggeeVersion
[in]目標 debuggee 中 CLR 的版本字串，由 CreateVersionStringFromModule 函式傳回。

szApplicationGroupId
[in]字串，表示在macOS中執行的沙箱化進程的應用程式群組標識碼。 如果進程未在macOS上的沙箱或其他平台上執行，則傳遞NULL。

pLibraryProvider
[in]用於尋找 DBI 和 DAC 的回呼介面實例。 請參閱 ICLRDebuggingLibraryProvider3 介面。

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 6.0 起提供