ICLRRuntimeInfo::IsLoaded, méthode

Article
08/10/2011

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

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

Paramètres

hndProcess
[in] Handle du 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 qui indiquent l'échec de la méthode.

HRESULT	Description
S_OK	La méthode s'est correctement terminée.
E_POINTER	pbLoaded a la valeur null.

Notes

La méthode est à compatibilité descendante avec les fonctions et les 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é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).

Un hôte peut appeler l'une des fonctions CorBindTo* déconseillées, telles que 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 la valeur true ; sinon, il retourne la valeur false.