Funzione CreateDebuggingInterfaceFromVersion2

Accetta una stringa di versione CLR (Common Language Runtime) restituita dalla funzione CreateVersionStringFromModule e restituisce un'interfaccia del debugger corrispondente (in genere ICorDebug).

Sintassi

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

Parametri

iDebuggerVersion
[in] La versione dell'interfaccia prevista dal debugger.

szDebuggeeVersion
[in] Stringa di versione di CLR nell'oggetto di debug di destinazione, restituita dalla funzione CreateVersionStringFromModule .

szApplicationGroupId
[in] Stringa che rappresenta l'ID del gruppo di applicazioni di un processo in modalità sandbox in esecuzione in macOS. Passare NULL se il processo non è in esecuzione in una sandbox in macOS o in altre piattaforme.

ppCordb
[out] Puntatore a un puntatore a un oggetto COM (IUnknown). Questo oggetto verrà sottoposto a cast a un oggetto ICorDebug prima che venga restituito.

Valore restituito

S_OK
ppCordb fa riferimento a un oggetto valido che implementa l'interfaccia dell'interfaccia ICorDebug .

E_INVALIDARG
szDebuggeeVersion O ppCordb è null.

CORDBG_E_DEBUG_COMPONENT_MISSING
Non è possibile individuare un componente necessario per il debug CLR. Impossibile trovare mscordbi.dll o mscordaccore.dll nella stessa directory del CoreCLR.dlldi destinazione.

CORDBG_E_INCOMPATIBLE_PROTOCOL
mscordbi.dll o mscordaccore.dll non è la stessa versione del CoreCLR.dlldi destinazione.

E_FAIL (o altri E_ codici restituiti)
Impossibile restituire un'interfaccia ICorDebug.

Osservazioni:

L'interfaccia restituita fornisce le funzionalità per il collegamento a un CLR in un processo di destinazione e il debug del codice gestito in cui è in esecuzione CLR.

Requisiti

Piattaforme: Vedere Sistemi operativi supportati da .NET.

Intestazione: dbgshim.h

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

Versioni di .NET: Disponibile a partire da .NET Core 3.1