Fonction CreateDebuggingInterfaceFromVersion2

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

Paramètres

iDebuggerVersion
[in] Version de l’interface attendue par le débogueur.

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

szApplicationGroupId
[in] Chaîne représentant l’ID de groupe d’applications d’un processus en bac à sable s’exécutant dans macOS. Transmettez NULL si le processus n’est pas en cours d’exécution dans un bac à sable sur macOS ou sur d’autres plateformes.

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 3.1