Funktionen CreateDebuggingInterfaceFromVersion2

Artikel
03/05/2024

Accepterar en CLR-versionssträng (Common Language Runtime) som returneras från funktionen CreateVersionStringFromModule och returnerar ett motsvarande felsökningsgränssnitt (vanligtvis ICorDebug).

Syntax

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

Parametrar

iDebuggerVersion
[i] Den version av gränssnittet som felsökaren förväntar sig.

szDebuggeeVersion
[i] Versionssträngen för CLR i målbuggee, som returneras av funktionen CreateVersionStringFromModule .

szApplicationGroupId
[i] En sträng som representerar programgrupps-ID för en sandbox-process som körs i macOS. Skicka NULL om processen inte körs i en sandbox-miljö på macOS eller på andra plattformar.

ppCordb
[ut] Pekare till en pekare till ett COM-objekt (IUnknown). Det här objektet skickas till ett ICorDebug-objekt innan det returneras.

Returvärde

S_OK
ppCordb refererar till ett giltigt objekt som implementerar gränssnittet för ICorDebug-gränssnittet .

E_INVALIDARG
Antingen szDebuggeeVersion eller ppCordb är null.

CORDBG_E_DEBUG_COMPONENT_MISSING
Det går inte att hitta en komponent som är nödvändig för CLR-felsökning. Det gick inte att hitta mscordbi.dll eller mscordaccore.dll i samma katalog som målet CoreCLR.dll.

CORDBG_E_INCOMPATIBLE_PROTOCOL
Antingen är mscordbi.dll eller mscordaccore.dll inte samma version som mål CoreCLR.dll.

E_FAIL (eller andra E_ returkoder)
Det går inte att returnera ett ICorDebug-gränssnitt.

Kommentarer

Gränssnittet som returneras ger möjlighet att ansluta till en CLR i en målprocess och felsöka den hanterade kod som CLR kör.

Behov

Plattformar: Se operativsystem som stöds av .NET.

Rubrik: dbgshim.h

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

.NET-versioner: Tillgänglig sedan .NET Core 3.1

Dela via