Partager via

Fonction CreateDebuggingInterfaceFromVersion (.NET Framework)

  • Article

Crée un objet ICorDebug basé sur les informations de version spécifiées.

La fonction est obsolète dans le .NET Framework 4. Au lieu de cela, pour obtenir une interface pour le Common Language Runtime (CLR) 2.0, utilisez la méthode ICLRRuntimeInfo::GetInterface, et spécifiez l’identificateur de classe CLSID_CLRDebuggingLegacy et l’identificateur d’interface IID_ICorDebug. Pour obtenir une interface pour CLR 4 ou ultérieur, appelez la fonction CLRCreateInstance, et spécifiez l’identificateur de classe CLSID_CLRDebugging et l’identificateur d’interface IID_ICLRDebugging.

Syntaxe

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

Paramètres

iDebuggerVersion
[in] La version de ICorDebug qui est attendue par le débogueur. Pour connaître les valeurs valides, consultez l’énumération CorDebugInterfaceVersion.

szDebuggeeVersion
[in] Version du Common Language Runtime associée à l’application ou au processus à déboguer. Pour plus d’informations sur la récupération de cette valeur, consultez la méthode GetVersionFromProcess ou GetRequestedRuntimeVersion.

ppCordb
[out] Emplacement qui reçoit un pointeur vers l’objet ICorDebug.

Valeur renvoyée

Cette méthode retourne des codes d’erreur COM standard tels que définis dans le fichier WinError.h, en plus des valeurs suivantes.

Code de retour Description
S_OK La commande s'est correctement terminée.
E_INVALIDARG szDebuggeeVersion ou ppCordb est Null, ou la chaîne de version est incorrecte.

Remarques

Le paramètre szDebuggeeVersion est mappé à la version correspondante de MSCorDbi.dll.

Configuration requise

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : MSCorEE.dll

Versions de .NET Framework : disponible depuis la version 2.0

Voir aussi