Funzione CreateDebuggingInterfaceFromVersion

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 CreateDebuggingInterfaceFromVersion (
    [in]  LPCWSTR      szDebuggeeVersion,
    [out] IUnknown**   ppCordb,
);

Parametri

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

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 2.1