Dela via

CorBindToRuntimeHost-funktion

  • Artikel

Gör att värdar kan läsa in en angiven version av CLR (Common Language Runtime) i en process.

Den här funktionen är inaktuell i .NET Framework 4.

Syntax

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  
);

Parametrar

pwszVersion
[i] En sträng som beskriver den version av CLR som du vill läsa in.

Ett versionsnummer i .NET Framework består av fyra delar avgränsade med punkter: major.minor.build.revision. Strängen som skickades som pwszVersion måste börja med tecknet "v" följt av de tre första delarna av versionsnumret (till exempel "v1.0.1529").

Vissa versioner av CLR installeras med en principsats som anger kompatibilitet med tidigare versioner av CLR. Som standard utvärderas start-shim mot principinstruktioner pwszVersion och läser in den senaste versionen av körningen som är kompatibel med den version som begärs. En värd kan tvinga shim att hoppa över principutvärderingen och läsa in den exakta versionen som anges i pwszVersion genom att skicka ett värde på STARTUP_LOADER_SAFEMODE för parametern startupFlags .

Om pwszVersion är nullläser metoden inte in någon version av CLR. I stället returneras CLR_E_SHIM_RUNTIMELOAD, vilket indikerar att det inte gick att läsa in körningen.

pwszBuildFlavor
[i] En sträng som anger om servern eller arbetsstationsversionen av CLR ska läsas in. Giltiga värden är svr och wks. Serverversionen är optimerad för att dra nytta av flera processorer för skräpsamlingar och arbetsstationsversionen är optimerad för klientprogram som körs på en dator med en processor.

Om pwszBuildFlavor värdet är null läses arbetsstationsversionen in. När du kör på en dator med en processor läses arbetsstationsversionen alltid in, även om pwszBuildFlavor den är inställd på svr. Men om pwszBuildFlavor är inställt på svr och samtidig skräpinsamling har angetts (se beskrivningen av parametern startupFlags ) läses serverversionen in.

Kommentar

Samtidig skräpinsamling stöds inte i program som kör WOW64 x86-emulatorn på 64-bitarssystem som implementerar Intel Itanium-arkitekturen (kallades tidigare IA-64). Mer information om hur du använder WOW64 på 64-bitars Windows-system finns i Köra 32-bitarsprogram.

pwszHostConfigFile
[i] Namnet på en värdkonfigurationsfil som anger vilken version av CLR som ska läsas in. Om filnamnet inte innehåller en fullständigt kvalificerad sökväg antas filen finnas i samma katalog som den körbara fil som gör anropet.

pReserved
[i] Reserverad för framtida utökningsbarhet.

startupFlags
[i] En uppsättning flaggor som styr samtidig skräpinsamling, domänneutral kod och parameterns pwszVersion beteende. Standardvärdet är en enskild domän om ingen flagga har angetts. En lista över värden som stöds finns i STARTUP_FLAGS uppräkning.

rclsid
[i] För CLSID den coclass som implementerar antingen ICorRuntimeHost eller ICLRRuntimeHost-gränssnittet . Värden som stöds är CLSID_CorRuntimeHost eller CLSID_CLRRuntimeHost.

riid
[i] Det IID gränssnitt som du begär. Värden som stöds är IID_ICorRuntimeHost eller IID_ICLRRuntimeHost.

ppv
[ut] En gränssnittspekare till den version av körningen som lästes in.

Krav

Plattformar: Se Systemkrav.

Rubrik: MSCorEE.idl

Bibliotek: MSCorEE.dll

.NET Framework-versioner: Finns sedan 1.0

Se även