ICLRRuntimeInfo::IsLoaded, méthode

Article
05/10/2023

Indique si le COMMON Language Runtime (CLR) associé à l’interface ICLRRuntimeInfo est chargé dans un processus. Un runtime peut être chargé sans être démarré.

Syntaxe

HRESULT IsLoaded(  
[in]  HANDLE hndProcess,  
[out, retval] BOOL *pbLoaded);

Paramètres

hndProcess
[in] Handle vers le processus.

pbLoaded
[out] true si le CLR est chargé dans le processus ; sinon, false.

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	`pbLoaded` a la valeur null.

Notes

Cette méthode offre une compatibilité descendante avec les fonctions et interfaces suivantes :

Interface ICorRuntimeHost (dans l’API d’hébergement .NET Framework version 1).
Interface ICLRRuntimeHost (dans l’API d’hébergement .NET Framework 2.0).
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).

Un hôte peut appeler l’une des fonctions CorBindTo* dépréciées, comme la fonction CorBindToRuntime, pour instancier une version spécifique du CLR. L’hôte peut ensuite appeler la méthode ICLRMetaHost::GetRuntime et spécifier le même numéro de version pour obtenir une interface ICLRRuntimeInfo.

Si l’hôte appelle ensuite la méthode IsLoaded sur l’interface ICLRRuntimeInfo retournée, pbLoaded retourne true ; sinon, false est retourné.

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

Partager via