CorBindToRuntimeHost, functie
Hiermee kunnen hosts een opgegeven versie van de Common Language Runtime (CLR) laden in een proces.
Deze functie is afgeschaft in .NET Framework 4.
Syntaxis
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
);
Parameters
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 van STARTUP_LOADER_SAFEMODE door te geven voor de startupFlags parameter.
Als pwszVersion dat het geval is null, laadt de methode geen versie van de CLR. In plaats daarvan wordt CLR_E_SHIM_RUNTIMELOAD geretourneerd, wat aangeeft dat de runtime niet kan 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.
Notitie
Gelijktijdige garbagecollection wordt niet ondersteund in toepassingen met de WOW64 x86-emulator op 64-bits systemen die de Intel Itanium-architectuur implementeren (voorheen IA-64 genoemd). Zie 32-bits toepassingen uitvoeren voor meer informatie over het gebruik van WOW64 op 64-bits Windows-systemen.
pwszHostConfigFile
[in] De naam van een hostconfiguratiebestand dat de versie van de CLR aangeeft die moet worden geladen. Als de bestandsnaam geen volledig gekwalificeerd pad bevat, wordt ervan uitgegaan dat het bestand zich in dezelfde map bevindt als het uitvoerbare bestand dat de aanroep doet.
pReserved
[in] Gereserveerd voor toekomstige uitbreidbaarheid.
startupFlags
[in] Een set vlaggen waarmee gelijktijdige garbagecollection, domeinneutrale code en het gedrag van de pwszVersion parameter worden bepaald. De standaardwaarde is één domein als er geen vlag is ingesteld. Zie de opsomming STARTUP_FLAGS voor een lijst met ondersteunde waarden.
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 interface die u aanvraagt. Ondersteunde waarden zijn IID_ICorRuntimeHost of IID_ICLRRuntimeHost.
ppv
[uit] Een interfaceaanwijzer naar de versie van de runtime die is geladen.
Vereisten
Platformen: Zie Systeemvereisten.
Header: MSCorEE.idl
Bibliotheek: MSCorEE.dll
.NET Framework-versies: beschikbaar sinds 1.0
