Partager via

CorBindToRuntime, fonction

Permet aux hôtes non managés de charger le Common Language Runtime (CLR) dans un processus.

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

Syntaxe

HRESULT CorBindToRuntime (
    [in]  LPCWSTR     pwszVersion,
    [in]  LPCWSTR     pwszBuildFlavor,
    [in]  REFCLSID    rclsid,
    [in]  REFIID      riid,
    [out] LPVOID FAR  *ppv
);

Paramètres

pwszVersion [in] Chaîne décrivant la version du CLR que vous souhaitez charger.

Un numéro de version dans .NET Framework se compose de quatre parties séparées par des périodes : major.minor.build.revision. 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 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 est pwszVersion évalué par rapport aux instructions de stratégie et charge la dernière version 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 en pwszVersion passant une valeur du STARTUP_LOADER_SAFEMODEflags paramètre, comme décrit ci-dessous.

Si l’appelant spécifie null pour pwszVersion, la dernière version du runtime est chargée. La transmission de la valeur Null ne permet pas à l’hôte de contrôler quelle version du runtime est chargée. Bien que cette approche puisse être appropriée 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 faut charger le serveur ou la build de station de travail du CLR. Les valeurs valides sont svr et wks. La build du 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 un ordinateur à processeur unique.

Si pwszBuildFlavor la valeur est null, la build de station de travail est chargée. Lors de l’exécution sur un ordinateur à processeur unique, la build de la station de travail est toujours chargée, même si elle pwszBuildFlavor est définie sur svr. Toutefois, s’il pwszBuildFlavor est défini svr sur et que le garbage collection simultané est spécifié (voir la description du flags paramètre), la build du serveur est chargée.

rclsid [in] De CLSID la coclasse qui implémente l’interface ICorRuntimeHost ou ICLRRuntimeHost . Les valeurs prises en charge sont CLSID_CorRuntimeHost ou CLSID_CLRRuntimeHost.

riid [in] De IID l’interface demandée à partir de rclsid. Les valeurs prises en charge sont IID_ICorRuntimeHost ou IID_ICLRRuntimeHost.

ppv [out] Pointeur d’interface retourné vers riid.

Remarques

Si pwszVersion elle spécifie une version d’exécution qui n’existe pas, CorBindToRuntimeEx retourne une valeur HRESULT de CLR_E_SHIM_RUNTIMELOAD.

CorBindToRuntimeEx et CorBindToRuntime effectuez la même opération, mais la CorBindToRuntimeEx fonction vous permet de définir des indicateurs pour spécifier le comportement du CLR.

Contexte d’exécution et flux d’identité Windows

Dans la version 1 du CLR, l’objet WindowsIdentity ne circule pas entre des points asynchrones tels que de nouveaux threads, pools de threads ou rappels de minuteur. Dans la version 2.0 du CLR, un ExecutionContext objet encapsule certaines informations sur le thread en cours d’exécution et le circule sur n’importe quel point asynchrone, mais pas sur les limites du domaine d’application. De même, l’objet WindowsIdentity circule également sur n’importe quel point asynchrone. Par conséquent, l’emprunt d’identité actuel sur le thread, le cas échéant, circule également.

Vous pouvez modifier le flux de deux façons :

  1. En modifiant les ExecutionContext paramètres pour supprimer le flux sur une base par thread (voir les SuppressFlowméthodes, SuppressFlowetc SuppressFlowWindowsIdentity .).

  2. En modifiant le mode par défaut du processus en mode de compatibilité version 1, où l’objet WindowsIdentity ne circule sur aucun point asynchrone, quels que soient les ExecutionContext paramètres du thread actuel. La façon dont vous modifiez le mode par défaut dépend de l’utilisation d’un exécutable managé ou d’une interface d’hébergement non managée pour charger le CLR :

    1. Pour les exécutables managés, vous devez définir l’attribut enabled de l’élément true<legacyImpersonationPolicy> sur .

    2. Pour les interfaces d’hébergement non managées, définissez l’indicateur STARTUP_LEGACY_IMPERSONATION dans le paramètre lors de l’appel flags de la CorBindToRuntimeEx fonction.

    Le mode de compatibilité version 1 s’applique à l’ensemble du processus et à tous les domaines d’application du processus.

Exigences

Plateformes : Consultez Configuration requise.

En-tête: MSCorEE.h

Bibliothèque : MSCorEE.dll

Versions de .NET Framework : Disponible à partir de la version 1.0

Voir également

  • Last updated on