LockClrVersion, fonction

Permet à l’hôte de déterminer la version du Common Language Runtime (CLR) utilisée au sein du processus avant d’initialiser explicitement le CLR.

Cette fonction a été dépréciée dans .NET Framework 4.

Syntaxe

HRESULT LockClrVersion (  
    [in] FLockClrVersionCallback   hostCallback,  
    [in] FLockClrVersionCallback  *pBeginHostSetup,  
    [in] FLockClrVersionCallback  *pEndHostSetup  
);  

Paramètres

hostCallback
[in] Fonction que le CLR doit appeler lors de l’initialisation.

pBeginHostSetup
[in] Fonction que l’hôte doit appeler pour informer le CLR que l’initialisation est en cours de démarrage.

pEndHostSetup
[in] Fonction que l’hôte doit appeler pour informer le CLR que l’initialisation est terminée.

Valeur de retour

Cette méthode retourne des codes d’erreur COM standard, tels que définis dans WinError.h, en plus des valeurs suivantes.

Notes

L’hôte appelle LockClrVersion avant d’initialiser le CLR. LockClrVersion prend trois paramètres, qui sont tous des rappels de type FLockClrVersionCallback. Ce type est défini comme suit.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();  

Les étapes suivantes se produisent lors de l’initialisation du runtime :

1. L’hôte appelle CorBindToRuntimeEx ou l’une des autres fonctions d’initialisation du runtime. L’hôte peut également initialiser le runtime à l’aide de l’activation d’objet COM.

2. Le runtime appelle la fonction spécifiée par le paramètre hostCallback.

3. La fonction spécifiée par hostCallback effectue ensuite la séquence d’appels suivante :

   • Fonction spécifiée par le paramètre pBeginHostSetup.

   • CorBindToRuntimeEx (ou une autre fonction d’initialisation du runtime).

   • ICLRRuntimeHost::SetHostControl.

   • ICLRRuntimeHost::Start.

   • Fonction spécifiée par le paramètre pEndHostSetup.

Tous les appels de pBeginHostSetup à pEndHostSetup doivent se produire sur un thread ou une fibre unique, avec la même pile logique. Ce thread peut être différent du thread sur lequel hostCallback est appelé.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : MSCorEE.dll

Versions de .NET Framework : disponible depuis la version 2.0

Voir aussi

• Fonction d'hébergement du CLR déconseillées