CorBindToRuntimeEx, functie

Hiermee kunnen niet-beheerde hosts de Common Language Runtime (CLR) in een proces laden. De CorBindToRuntime en CorBindToRuntimeEx functies voeren dezelfde bewerking uit, maar met de CorBindToRuntimeEx functie kunt u vlaggen instellen om het gedrag van de CLR op te geven.

Deze functie is afgeschaft in .NET Framework 4.

Deze functie gebruikt een set parameters waarmee een host het volgende kan doen:

• Geef de versie op van de runtime die wordt geladen.

• Geef aan of de build van de server of het werkstation moet worden geladen.

• Bepalen of gelijktijdige garbagecollection of niet-gelijktijdige garbagecollection wordt uitgevoerd.

• Bepalen of assembly's als domeinneutraal worden geladen.

• Verkrijg een interfaceaanwijzer naar een ICorRuntimeHost die kan worden gebruikt om extra opties in te stellen voor het configureren van een exemplaar van de CLR voordat deze wordt gestart.

Syntaxis

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

Parameterwaarden

pwszVersion [in] Een tekenreeks die de versie van de CLR beschrijft die u wilt laden.

Een versienummer in .NET Framework bestaat uit vier onderdelen, gescheiden door punten: major.minor.build.revision. De tekenreeks die wordt doorgegeven als pwszVersion moet beginnen met het teken 'v' gevolgd door de eerste drie delen van het versienummer (bijvoorbeeld 'v1.0.1529').

Sommige versies van de CLR worden geïnstalleerd met een beleidsinstructie die compatibiliteit met eerdere versies van de CLR aangeeft. Standaard evalueert pwszVersion de opstart-shim op basis van beleidsinstructies en laadt de nieuwste versie van de runtime die compatibel is met de versie die wordt aangevraagd. Een host kan afdwingen dat de shim beleidsevaluatie overslaat en de exacte versie laadt die is pwszVersion opgegeven door een waarde voor STARTUP_LOADER_SAFEMODE de startupFlags parameter door te geven, zoals hieronder wordt beschreven.

Als de aanroeper null pwszVersionopgeeft voor, CorBindToRuntimeEx identificeert u de set geïnstalleerde runtimes waarvan de versienummers lager zijn dan de .NET Framework 4-runtime en laadt u de nieuwste versie van de runtime uit die set. Het .NET Framework 4 of hoger wordt niet geladen en mislukt als er geen eerdere versie is geïnstalleerd. Houd er rekening mee dat het doorgeven van null de host geen controle geeft over welke versie van de runtime wordt geladen. Hoewel deze benadering in sommige scenario's geschikt kan zijn, wordt het sterk aanbevolen dat de host een specifieke versie levert die moet worden geladen.

pwszBuildFlavor [in] Een tekenreeks die aangeeft of de server of het werkstation-build van de CLR moet worden geladen. Geldige waarden zijn svr en wks. De serverbuild is geoptimaliseerd om te profiteren van meerdere processors voor garbagecollections en de build van het werkstation is geoptimaliseerd voor clienttoepassingen die worden uitgevoerd op een computer met één processor.

Als pwszBuildFlavor dit is ingesteld op null, wordt de build van het werkstation geladen. Wanneer de computer met één processor wordt uitgevoerd, wordt de build van het werkstation altijd geladen, zelfs als pwszBuildFlavor dit is ingesteld op svr. pwszBuildFlavor Als echter is ingesteld op svr en gelijktijdige garbagecollection is opgegeven (zie de beschrijving van de startupFlags parameter), wordt de serverbuild geladen.

startupFlags [in] Een combinatie van waarden van de opsomming STARTUP_FLAGS . Deze vlaggen beheren gelijktijdige garbagecollection, domeinneutrale code en het gedrag van de pwszVersion parameter. De standaardwaarde is één domein als er geen vlag is ingesteld. De volgende waarden zijn geldig:

• STARTUP_CONCURRENT_GC

• STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN

• STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN

• STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST

• STARTUP_LOADER_SAFEMODE

• STARTUP_LOADER_SETPREFERENCE

• STARTUP_SERVER_GC

• STARTUP_HOARD_GC_VM

• STARTUP_SINGLE_VERSION_HOSTING_INTERFACE

• STARTUP_LEGACY_IMPERSONATION

• STARTUP_DISABLE_COMMITTHREADSTACK

• STARTUP_ALWAYSFLOW_IMPERSONATION

Zie de opsomming STARTUP_FLAGS voor beschrijvingen van deze vlaggen.

rclsid [in] De CLSID coklasse die de ICorRuntimeHost of de ICLRRuntimeHost-interface implementeert. Ondersteunde waarden worden CLSID_CorRuntimeHost of CLSID_CLRRuntimeHost.

riid [in] De IID aangevraagde interface van rclsid. Ondersteunde waarden zijn IID_ICorRuntimeHost of IID_ICLRRuntimeHost.

ppv [uit] De geretourneerde interface-aanwijzer naar riid.

Opmerkingen

Als pwszVersion er een runtimeversie wordt opgegeven die niet bestaat, CorBindToRuntimeEx wordt een HRESULT-waarde van CLR_E_SHIM_RUNTIMELOAD geretourneerd.

Uitvoeringscontext en stroom van Windows-identiteit

In versie 1 van de CLR loopt het WindowsIdentity object niet over asynchrone punten, zoals nieuwe threads, threadpools of timer callbacks. In versie 2.0 van de CLR verpakt een ExecutionContext object enkele informatie over de momenteel uitgevoerde thread en wordt deze over een asynchroon punt gestroomd, maar niet over grenzen van toepassingsdomeinen. Op dezelfde manier loopt het WindowsIdentity object ook over een asynchroon punt. Daarom stroomt de huidige imitatie op de thread, indien van toepassing, ook.

U kunt de stroom op twee manieren wijzigen:

1. Door de ExecutionContext instellingen te wijzigen om de stroom per thread te onderdrukken (zie de SuppressFlow, SuppressFlowen SuppressFlowWindowsIdentity methoden).

2. Door de standaardmodus van het proces te wijzigen in de compatibiliteitsmodus versie 1, waarbij het WindowsIdentity object niet over een asynchroon punt stroomt, ongeacht de ExecutionContext instellingen in de huidige thread. Hoe u de standaardmodus wijzigt, is afhankelijk van of u een beheerd uitvoerbaar bestand of een niet-beheerde hostinginterface gebruikt om de CLR te laden:

   1. Voor beheerde uitvoerbare bestanden moet u het enabled kenmerk van het <legacyImpersonationPolicy-element> instellen op true.

   2. Voor niet-beheerde hostinginterfaces stelt u de STARTUP_LEGACY_IMPERSONATION vlag in de startupFlags parameter in bij het aanroepen van de CorBindToRuntimeEx functie.

   De compatibiliteitsmodus versie 1 is van toepassing op het hele proces en op alle toepassingsdomeinen in het proces.

Requirements

Platformen: Zie Systeemvereisten.

Rubriek: MSCorEE.h

Bibliotheek: MSCorEE.dll

.NET Framework-versies: beschikbaar sinds 1.0

Zie ook

• CorBindToCurrentRuntime, functie
• CorBindToRuntime, functie
• CorBindToRuntimeByCfg, functie
• CorBindToRuntimeHost, functie
• ICorRuntimeHost-interface
• Afgeschafte CLR-hostingfuncties