Funzione CreateDebuggingInterfaceFromVersion

Articolo
03/03/2024

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). Per questo oggetto verrà eseguito il cast in un oggetto ICorDebug prima che venga restituito.

Valore restituito

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

E_INVALIDARG
szDebuggeeVersion o ppCordb è null.

CORDBG_E_DEBUG_COMPONENT_MISSING
Impossibile trovare un componente necessario per il debug CLR. Impossibile trovare mscordbi.dll o mscordaccore.dll nella stessa directory del CoreCLR.dll di destinazione.

CORDBG_E_INCOMPATIBLE_PROTOCOL
Significa che la versione di mscordaccore.dll o mscordbi.dll non corrisponde a quella del file CoreCLR.dll di destinazione.

E_FAIL (o altri codici E_ restituiti)
Non è possibile restituire un’interfaccia ICorDebug.

Osservazioni:

L'interfaccia restituita fornisce funzionalità per connettersi a un CLR nel processo di destinazione ed eseguire il debug del codice gestito eseguito da CLR.

Requisiti

Piattaforme: vedere Sistemi operativi supportati da .NET.

Intestazione: dbgshim.h

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

Versioni .NET: disponibili a partire da .NET Core 2.1

Condividi tramite