Metodo ICLRMetaHost::GetRuntime

Articolo
08/11/2011

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

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 a versione principale, versione secondaria e numero di build.

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

Alcuni esempi di valori 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 che corrisponde al runtime richiesto.

Valore restituito

Questo metodo restituisce gli HRESULT specifici seguenti nonché gli errori HRESULT che indicano l'esito negativo del metodo.

HRESULT	Oggetto di descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_POINTER	pwzVersion o ppRuntime è null.

Note

Questo metodo interagisce costantemente con le interfacce legacy come l'interfaccia ICorRuntimeHost e le funzioni legacy come quelle CorBindTo* deprecate (vedere Funzioni statiche globali di hosting di .NET Framework 1.1 e 2.0 nell'API di hosting di .NET Framework 2.0). Ovvero, runtime caricati con API legacy sono visibili alla nuova API, e i runtime caricati con nuove API sono visibili alle API legacy. .