Fonction CreateDebuggingInterfaceFromVersion2

Article
10/03/2023

Accepte une chaîne de version du Common Language Runtime (CLR) retournée par la fonction CreateVersionStringFromModule et retourne une interface de débogueur correspondante (en général, 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 l’élément débogué cible, qui est retournée par la fonction CreateVersionStringFromModule.

szApplicationGroupId
[in] Chaîne représentant l’ID du groupe d’applications d’un processus en bac à sable s’exécutant dans macOS. Passe NULL si le processus e s’exécute pas dans un bac à sable sur macOS ou sur d’autres plateformes.

ppCordb
[out] Pointeur vers un autre pointeur vers un objet COM (IUnknown). Cet objet sera casté en objet ICorDebug avant d’être retourné.

Valeur retournée

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

E_INVALIDARG
szDebuggeeVersion ou ppCordb a la valeur null.

CORDBG_E_DEBUG_COMPONENT_MISSING
Un composant nécessaire pour le débogage CLR est introuvable. mscordbi.dll ou mscordaccore.dll est introuvable dans le répertoire dans lequel figure le fichier CoreCLR.dll cible.

CORDBG_E_INCOMPATIBLE_PROTOCOL
La version de mscordbi.dll ou de mscordaccore.dll n'est pas la même que celle du fichier CoreCLR.dll cible.

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

Notes

L'interface retournée fournit les fonctionnalités permettant l'attachement à un CLR dans un processus cible et le débogage du code managé exécuté par le CLR.

Spécifications

Plateformes : Consultez 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

Partager via