Partager via


Fonction CreateDebuggingInterfaceFromVersion

Accepte une chaîne de version CLR (Common Language Runtime) retournée par la fonction CreateVersionStringFromModule et retourne une interface de débogueur correspondante (généralement ICorDebug).

Syntaxe

HRESULT CreateDebuggingInterfaceFromVersion (
    [in]  LPCWSTR      szDebuggeeVersion,
    [out] IUnknown**   ppCordb,
);

Paramètres

szDebuggeeVersion
[in] Chaîne de version du CLR dans le débogage cible, qui est retournée par la fonction CreateVersionStringFromModule.

ppCordb
[out] Pointeur vers un pointeur vers un objet COM (IUnknown). Cet objet est converti en objet ICorDebug avant son retour.

Valeur retournée

S_OK
ppCordb fait référence à un objet valide qui implémente l’interface de l’interface ICorDebug .

E_INVALIDARG
La szDebuggeeVersion valeur null ou ppCordb la valeur est null.

CORDBG_E_DEBUG_COMPONENT_MISSING
Un composant nécessaire pour le débogage CLR ne peut pas être localisé. mscordbi.dll ou mscordaccore.dll n’a pas été trouvé dans le même répertoire que le CoreCLR.dllcible.

CORDBG_E_INCOMPATIBLE_PROTOCOL
mscordbi.dll ou mscordaccore.dll n’est pas la même version que la CoreCLR.dllcible.

E_FAIL (ou d’autres E_ codes de retour)
Impossible de retourner une interface ICorDebug.

Remarques

L’interface retournée fournit les fonctionnalités permettant d’attacher à un CLR dans un processus cible et de déboguer le code managé que le CLR exécute.

Spécifications

Plates-formes: Consultez les systèmes d’exploitation pris en charge par .NET.

En-tête : dbgshim.h

Bibliothèque : dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Versions de .NET : Disponible depuis .NET Core 2.1