CorBindToRuntimeHost, fonction
Permet aux hôtes de charger une version spécifiée du Common Language Runtime (CLR) dans un processus.
Cette fonction a été dépréciée dans le .NET Framework 4.
Syntaxe
HRESULT CorBindToRuntimeHost (
[in] LPCWSTR pwszVersion,
[in] LPCWSTR pwszBuildFlavor,
[in] LPCWSTR pwszHostConfigFile,
[in] VOID* pReserved,
[in] DWORD startupFlags,
[in] REFCLSID rclsid,
[in] REFIID riid,
[out] LPVOID FAR *ppv
);
Paramètres
pwszVersion
[in] Chaîne décrivant la version du CLR que vous voulez charger.
Un numéro de version dans le .NET Framework se compose de quatre parties séparées par des points : majeure.mineure.build.révision. La chaîne passée comme pwszVersion doit commencer par le caractère « v » suivi des trois premières parties du numéro de version (par exemple, « v1.0.1529 »).
Certaines versions du CLR sont installées avec une déclaration de stratégie qui spécifie la compatibilité avec les versions précédentes du CLR. Par défaut, le shim de démarrage évalue pwszVersion par rapport aux déclarations de la stratégie et charge la version la plus récente du runtime compatible avec la version demandée. Un hôte peut forcer le shim à ignorer l’évaluation de la stratégie et à charger la version exacte spécifiée dans pwszVersion en passant la valeur de STARTUP_LOADER_SAFEMODE pour le paramètre startupFlags.
Si pwszVersion c’est nullle cas, la méthode ne charge aucune version du CLR. À la place, elle retourne CLR_E_SHIM_RUNTIMELOAD, qui indique qu’elle n’a pas pu charger le runtime.
pwszBuildFlavor
[in] Chaîne qui spécifie s’il faut charger la build pour serveur ou pour station de travail du CLR. Les valeurs valides sont svr et wks. La build pour serveur est optimisée pour tirer parti de plusieurs processeurs pour les garbage collections, et la build de station de travail est optimisée pour les applications clientes s’exécutant sur une machine monoprocesseur.
Si pwszBuildFlavor est défini sur Null, la build pour station de travail est chargée. Lors de l’exécution sur une machine monoprocesseur, la build pour station de travail est toujours chargée, même si pwszBuildFlavor est défini sur svr. Cependant, si pwszBuildFlavor est défini sur svr et qu’un garbage collection simultané est spécifié (consultez la description du paramètre startupFlags), la build pour serveur est chargée.
Notes
Le garbage collection simultané n’est pas pris en charge dans les applications qui exécutent l’émulateur WOW64 x86 sur des systèmes 64 bits implémentant l’architecture Intel Itanium (anciennement appelée IA-64). Pour plus d’informations sur l’utilisation de WOW64 sur des systèmes Windows 64 bits, consultez Exécution d’applications 32 bits.
pwszHostConfigFile
[in] Nom d’un fichier de configuration d’hôte qui spécifie la version du CLR à charger. Si le nom de fichier n’inclut pas un chemin complet, le fichier est supposé se trouver dans le même répertoire que l’exécutable qui effectue l’appel.
pReserved
[in] Réservé à des fins d’extensibilité future.
startupFlags
[in] Un ensemble d’indicateurs qui contrôle le garbage collection simultané, le code indépendant du domaine et le comportement du paramètre pwszVersion. La valeur par défaut est un seul domaine si aucun indicateur n’est défini. Pour obtenir la liste des valeurs prises en charge, consultez Énumération STARTUP_FLAGS.
rclsid
[in] Le CLSID de la coclasse qui implémente le ICorRuntimeHost ou l’interface ICLRRuntimeHost. Les valeurs prises en charge sont CLSID_CorRuntimeHost ou CLSID_CLRRuntimeHost.
riid
[in] IID de l’interface que vous demandez. Les valeurs prises en charge sont IID_ICorRuntimeHost ou IID_ICLRRuntimeHost.
ppv
[out] Pointeur d’interface vers la version du runtime qui a été chargée.
Configuration requise
Plateformes : Consultez Configuration requise.
En-tête : MSCorEE.idl
Bibliothèque : MSCorEE.dll
Versions de .NET Framework : disponible depuis la version 1.0
