CreateDebuggingInterfaceFromVersion3 – funkce

Článek
03/02/2024

Přijímá řetězec verze modulu CLR (Common Language Runtime), který je vrácen z funkce CreateVersionStringFromModule a vrací odpovídající rozhraní ladicího programu (obvykle ICorDebug).

Syntaxe

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

Parametry

iDebuggerVersion
[v] Verze rozhraní, které ladicí program očekává.

szDebuggeeVersion
[v] Řetězec verze CLR v cílové ladicíge, který je vrácen CreateVersionStringFromModule funkce.

szApplicationGroupId
[v] Řetězec představující ID skupiny aplikací procesu v izolovaném prostoru (sandbox) spuštěného v systému macOS. Pokud proces není spuštěný v sandboxu v systému macOS nebo na jiných platformách, předejte hodnotu NULL.

pLibraryProvider
[v] Instance rozhraní zpětného volání pro vyhledání dbI a DAC. Viz ICLRDebuggingLibraryProvider3 rozhraní.

ppCordb
[ven] Ukazatel na ukazatel na objekt MODELU COM (IUnknown). Tento objekt bude před vrácením přetypován na objekt ICorDebug .

Vrácená hodnota

S_OK
ppCordb odkazuje na platný objekt, který implementuje ICorDebug rozhraní .

E_INVALIDARG
Buď szDebuggeeVersion nebo ppCordb má hodnotu null.

CORDBG_E_DEBUG_COMPONENT_MISSING
Komponentu, která je nezbytná pro ladění CLR, se nedá najít. Mscordbi.dll nebo mscordaccore.dll nebyly nalezeny ve stejném adresáři jako cílová CoreCLR.dll.

CORDBG_E_INCOMPATIBLE_PROTOCOL
Verze mscordbi.dll nebo mscordaccore.dll není stejná jako cílová CoreCLR.dll.

E_FAIL (nebo jiné E_ návratové kódy)
Nelze vrátit rozhraní ICorDebug.

Poznámky

Vrácené rozhraní poskytuje zařízení pro připojení k CLR v cílovém procesu a ladění spravovaného kódu, který clR běží.

Požadavky

Platformy: Viz podporované operační systémy .NET.

Hlavička: dbgshim.h

Knihovna: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Verze .NET: Dostupné od .NET 6.0

Sdílet prostřednictvím