Funzione CreateDebuggingInterfaceFromVersion3

Articolo
03/12/2024

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

Sintassi

HRESULT CreateDebuggingInterfaceFromVersion3 (
    [in] int iDebuggerVersion,
    [in] LPCWSTR szDebuggeeVersion,
    [in] LPCWSTR szApplicationGroupId,
    [in] ICLRDebuggingLibraryProvider3* pLibraryProvider,
    [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.

pLibraryProvider
[in] Un'istanza dell'interfaccia di callback per l'individuazione di database e applicazione livello dati. Vedere l'interfaccia ICLRDebuggingLibraryProvider3.

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: disponibile a partire da .NET 6.0

Condividi tramite