Partager via


ICLRMetaHost::GetRuntime, méthode

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.

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 secondaire et au numéro de build.

    RemarqueRemarque

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

    Les valeurs d'exemple sont « v1.0.3705 », « v1.1.4322 », « v2.0.50727 » et « v4.X », où X dépend du numéro de build installée. Le préfixe « v » est obligatoire.

  • riid
    [in] Identificateur pour l'interface désiré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 qui indiquent l'échec de la méthode.

HRESULT

Description

S_OK

La méthode s'est correctement terminée.

E_POINTER

pwzVersion ou ppRuntime est null.

Notes

Cette méthode interagit régulièrement avec les interfaces héritées telles que l'interface ICorRuntimeHost et les fonctions héritées telles que les fonctions CorBindTo* déconseillées (consultez Fonctions statiques globales de l'hébergement .NET Framework 1.1 et 2.0 dans l'API d'hébergement .NET Framework 2.0). Autrement dit, les runtimes chargés avec l'API héritée sont visibles à la nouvelle API, et les runtimes chargés avec la nouvelle API sont visibles à l'API héritée. .

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MetaHost.h

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

Versions du .NET Framework : 4

Voir aussi

Référence

ICLRMetaHost, interface

Autres ressources

Interfaces de gestion d'hébergement de .NET Framework 1.0 et 1.1

Interfaces d'hébergement de .NET Framework 2.0

Fonctions statiques globales de l'hébergement .NET Framework 1.1 et 2.0

Hébergement (Référence des API non managées)