ICLRMetaHost::GetRuntime-metod

Artikel
05/10/2023

Hämtar gränssnittet ICLRRuntimeInfo som motsvarar en viss version av CLR (Common Language Runtime). Den här metoden ersätter funktionen CorBindToRuntimeEx som används med flaggan STARTUP_LOADER_SAFEMODE .

Syntax

HRESULT GetRuntime (  
    [in] LPCWSTR pwzVersion,  
    [in] REFIID riid,  
    [out,iid_is(riid), retval] LPVOID *ppRuntime  
);

Parametrar

pwzVersion
[i] Den .NET Framework kompileringsversion som lagras i metadata, i formatet "vA. B[. X]". A, B och X är decimaltal som motsvarar huvudversionen, delversionen och versionsnumret.

Anteckning

Den här parametern måste matcha katalognamnet för den .NET Framework versionen, eftersom den visas under C:\Windows\Microsoft.NET\Framework eller C:\Windows\Microsoft.NET\Framework64.

Exempelvärden är "v1.0.3705", "v1.1.4322", "v2.0.50727" och "v4.0. X", där X är beroende av det installerade versionsnumret. Prefixet "v" krävs.

riid
[i] Identifieraren för önskat gränssnitt. För närvarande är det enda giltiga värdet för den här parametern IID_ICLRRuntimeInfo.

ppRuntime
[ut] En pekare till gränssnittet ICLRRuntimeInfo som motsvarar den begärda körningen.

Returvärde

Den här metoden returnerar följande specifika HRESULT-fel samt HRESULT-fel som indikerar metodfel.

HRESULT	Description
S_OK	Metoden har slutförts.
E_POINTER	`pwzVersion` eller `ppRuntime` är null.

Kommentarer

Den här metoden interagerar konsekvent med äldre gränssnitt som ICorRuntimeHost-gränssnittet och äldre funktioner som de inaktuella CorBindTo* funktionerna (se Inaktuella CLR-värdfunktioner i .NET Framework 2.0-värd-API:et). Det vill säger att körningsmiljöer som läses in med det äldre API:et är synliga för det nya API:et, och körningsmiljöer som läses in med det nya API:et är synliga för det äldre API:et.

Krav

Plattformar: Se Systemkrav.

Huvudet: MetaHost.h

Bibliotek: Ingår som en resurs i MSCorEE.dll

.NET Framework versioner: Tillgänglig sedan 4

Dela via