Partager via

ICLRMetaHost::GetRuntime, méthode

  • Article

Obtient l’interface ICLRRuntimeInfo qui correspond à une version particulière du Common Language Runtime (CLR). Cette méthode remplace la fonction CorBindToRuntimeEx utilisée avec l’indicateur STARTUP_LOADER_SAFEMODE.

Syntaxe

HRESULT GetRuntime (  
    [in] LPCWSTR pwzVersion,  
    [in] REFIID riid,  
    [out,iid_is(riid), retval] LPVOID *ppRuntime  
);

Paramètres

pwzVersion
[in] Version de compilation du .NET Framework stockée dans les métadonnées, au format « vA.B[.X] ». A, B et X sont des nombres décimaux qui correspondent à la version principale, à la version mineure et au numéro de build.

Notes

Ce paramètre doit correspondre au nom de répertoire de la version de .NET Framework, tel qu’il apparaît sous C:\Windows\Microsoft.NET\Framework ou C:\Windows\Microsoft.NET\Framework64.

Ses valeurs sont par exemple « v1.0.3705 », « v1.1.4322 », « v2.0.50727 » et « v4.0.X », où X dépend du numéro de build installé. Le préfixe « v » est nécessaire.

riid
[in] Identificateur de l’interface souhaitée. Actuellement, la seule valeur valide pour ce paramètre est IID_ICLRRuntimeInfo.

ppRuntime
[out] Pointeur vers l’interface ICLRRuntimeInfo qui correspond au runtime demandé.

Valeur de retour

Cette méthode retourne les HRESULT spécifiques suivants ainsi que les erreurs HRESULT indiquant l'échec de la méthode.

HRESULT Description
S_OK La commande s'est correctement terminée.
E_POINTER pwzVersion ou ppRuntime est null.

Notes

Cette méthode interagit de manière cohérente avec les interfaces héritées comme l’interface ICorRuntimeHost et les fonctions héritées comme les fonctions CorBindTo* dépréciées (consultez Fonctions d’hébergement CLR dépréciées dans l’API d’hébergement .NET Framework 2.0). Autrement dit, les runtimes chargés avec l’API héritée sont visibles pour la nouvelle API et les runtimes chargés avec la nouvelle API sont visibles pour l’API héritée.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MetaHost.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponibles depuis 4

Voir aussi