ICLRMetaHost::GetRuntime, méthode

Article
08/10/2011

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.

Remarque
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. .