CorBindToRuntimeHost, fonction

Article
08/22/2008

Mise à jour : novembre 2007

Permet aux hôtes de charger une version spécifiée du Common Language Runtime (CLR) dans un processus.

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 à charger.

Dans le .NET Framework, un numéro de version est constitué de quatre parties séparées par des points : major.minor.build.revision. La chaîne passée en tant que 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 instruction 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 en fonction des instructions de stratégie et charge la dernière version du runtime compatible avec la version demandée. Un hôte peut obliger le shim à ignorer l'évaluation de stratégie et à charger la version exacte spécifiée dans pwszVersion en passant une valeur de STARTUP_LOADER_SAFEMODE pour le paramètre startupFlags.

Si l'appelant spécifie null pour pwszVersion, la dernière version du CLR est chargée. Lorsque la valeur null est passée, l'hôte n'a aucun contrôle sur la version du runtime qui est chargée. Bien que cette approche puisse convenir dans certains scénarios, il est fortement recommandé que l'hôte fournisse une version spécifique à charger.

pwszBuildFlavor
[in] Chaîne qui spécifie s'il convient de charger la build du serveur ou de la station de travail du CLR. Les valeurs valides sont svr et wks. La build du serveur est optimisée de manière à utiliser plusieurs processeurs pour les garbage collection, tandis que la build de la station de travail est optimisée pour les applications clientes s'exécutant sur un ordinateur à un seul processeur.

Si la valeur de pwszBuildFlavor est null, la build de la station de travail est chargée. Lors de l'exécution sur un ordinateur à un seul processeur, la build de la station de travail est toujours chargée, même si pwszBuildFlavora pour valeur svr. Toutefois, si pwszBuildFlavora pour valeur svr et qu'un garbage collection simultané est spécifié (consultez la description du paramètre startupFlags ci-dessous), la build du serveur est chargée.

Remarque :
Le garbage collection simultané n'est pas pris en charge dans les applications exécutant l'émulateur WOW64 x86 sur les systèmes 64 bits qui implémentent l'architecture Intel Itanium (anciennement appelée IA-64). Pour plus d'informations sur l'utilisation de WOW64 sur les systèmes Windows 64 bits, consultez Exécution d'applications 32 bits (en anglais).

pwszHostConfigFile
[in] Nom d'un fichier de configuration hôte qui spécifie la version du CLR à charger. Si le nom du fichier ne comprend pas un chemin d'accès complet, il est supposé se trouver dans le même répertoire que l'exécutable qui effectue l'appel.
pReserved
[in] Réservé pour une future extensibilité.
startupFlags
[in] Ensemble d'indicateurs qui contrôlent le garbage collection simultané, le code indépendant du domaine et le comportement du paramètre pwszVersion. La valeur par défaut est un domaine unique si aucun indicateur n'est défini. Les valeurs suivantes sont prises en charge :
- STARTUP_CONCURRENT_GC : Spécifie que ce garbage collection simultané doit être utilisé. Si l'appelant demande la build du serveur et indique le garbage collection simultané sur un ordinateur à processeur unique, la build de la station de travail et le garbage collection non simultané sont utilisés à la place.
- STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN : Spécifie qu'aucun assembly n'est chargé comme indépendant du domaine.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN : Spécifie que tous les assemblys sont chargés comme indépendants du domaine.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST : Spécifie que tous les assemblys avec nom fort sont chargés comme indépendants du domaine.
- STARTUP_LOADER_SAFEMODE : Spécifie que la version exacte du CLR passée dans pwszVersion sera chargée. Le shim n'évalue pas la stratégie pour déterminer la dernière version compatible.
rclsid
[in] CLSID de la coclasse qui implémente l'interface que vous recherchez. Les valeurs prises en charge sont CLSID_CorRuntimeHost ou null.
riid
[in] IID de l'interface que vous demandez. Les valeurs prises en charge pour la version initiale du runtime sont IID_ICorRuntimeHost ou null.
ppv
[out] Pointeur d'interface vers la version du runtime qui a été chargée.