LockClrVersion, fonction

Article
08/10/2011

Permet à l'hôte de déterminer la version du Common Language Runtime (CLR) à utiliser dans le processus avant de l'initialiser explicitement.

Cette fonction est déconseillée dans le .NET Framework version 4.

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

Paramètres

hostCallback
[in] Fonction que le Common Language Runtime (CLR) doit appeler au moment de l'initialisation.
pBeginHostSetup
[in] Fonction que l'hôte doit appeler pour informer le CLR du démarrage de l'initialisation.
pEndHostSetup
[in] Fonction que l'hôte doit appeler pour informer le CLR de la fin de l'initialisation.

Valeur de retour

Cette méthode retourne des codes d'erreur COM standard, comme indiqué dans WinError.h, en plus des valeurs suivantes.

Code de retour	Description
S_OK	La méthode s'est correctement terminée.
E_INVALIDARG	Un ou plusieurs arguments sont null.

Notes

L'hôte appelle LockClrVersion avant d'initialiser le CLR. LockClrVersion prend trois paramètres de rappel de type FLockClrVersionCallback. Ce type est défini comme suit.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

Les étapes suivantes se produisent au moment de l'initialisation du runtime :

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'objets COM.
L'exécution appelle la fonction spécifiée par le paramètre hostCallback
La fonction spécifiée par hostCallback fait ensuite la séquence suivante d'appels :
- La fonction spécifiée par le paramètre pBeginHostSetup.
- CorBindToRuntimeEx (ou une autre fonction d'initialisation du runtime).
- ICLRRuntimeHost::SetHostControl.
- ICLRRuntimeHost::Start.
- La fonction spécifiée par le paramètre pEndHostSetup.

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

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.h

Bibliothèque : MSCorEE.dll

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Voir aussi

Autres ressources

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

Partager via