Metodo ICLRMetaHost::GetRuntime

Articolo
05/10/2023

Ottiene l'interfaccia ICLRRuntimeInfo che corrisponde a una determinata versione di Common Language Runtime (CLR). Questo metodo sostituisce la funzione CorBindToRuntimeEx usata con il flag di STARTUP_LOADER_SAFEMODE .

Sintassi

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

Parametri

pwzVersion
[in] Versione di compilazione di .NET Framework archiviata nei metadati, nel formato "vA. B[. X]". A, B e X sono numeri decimali che corrispondono alla versione principale, alla versione secondaria e al numero di compilazione.

Nota

Questo parametro deve corrispondere al nome della directory per la versione di .NET Framework, come viene visualizzato in C:\Windows\Microsoft.NET\Framework o C:\Windows\Microsoft.NET\Framework64.

I valori di esempio sono "v1.0.3705", "v1.1.4322", "v2.0.50727" e "v4.0. X", dove X dipende dal numero di build installato. Il prefisso "v" è obbligatorio.

riid
[in] Identificatore dell'interfaccia desiderata. Attualmente, l'unico valore valido per questo parametro è IID_ICLRRuntimeInfo.

ppRuntime
[out] Puntatore all'interfaccia ICLRRuntimeInfo corrispondente al runtime richiesto.

Valore restituito

Questo metodo restituisce gli specifici HRESULT seguenti, nonché gli errori di HRESULT che indicano la mancata riuscita del metodo.

HRESULT	Descrizione
S_OK	Metodo completato correttamente.
E_POINTER	`pwzVersion` o `ppRuntime` è null.

Commenti

Questo metodo interagisce in modo coerente con le interfacce legacy, ad esempio l'interfaccia ICorRuntimeHost e le funzioni legacy, ad esempio le funzioni di hosting DEPrecateCorBindTo* di CLR nell'API di hosting di .NET Framework 2.0. Vale a dire, i runtime caricati con l'API legacy sono visibili alla nuova API e i runtime caricati con la nuova API sono visibili all'API legacy.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MetaHost.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile da 4

Condividi tramite