Interfaccia ICLRMetaHost

  • Articolo

Fornisce metodi che restituiscono una versione specifica di Common Language Runtime (CLR) in base al numero di versione, elencano tutti i CLR installati, elencano tutti i runtime caricati in un processo specificato, individuano la versione CLR usata per compilare un assembly, uscire da un processo con un arresto di runtime pulito ed eseguire query sull'associazione api legacy.

Metodi

Metodo Descrizione
Metodo EnumerateInstalledRuntimes Restituisce un'enumerazione che contiene un puntatore all'interfaccia ICLRRuntimeInfo valido per ogni versione CLR installata in un computer.
Metodo EnumerateLoadedRuntimes Restituisce un'enumerazione che contiene un puntatore di interfaccia ICLRRuntimeInfo valido per ogni CLR caricato in un determinato processo. Questo metodo sostituisce GetVersionFromProcess.
Metodo ExitProcess Tenta di arrestare tutti i runtime caricati normalmente e quindi termina il processo. Sostituisce la funzione CorExitProcess .
Metodo GetRuntime Ottiene l'interfaccia ICLRRuntimeInfo che corrisponde a una determinata versione CLR. Questo metodo sostituisce la funzione CorBindToRuntimeEx usata con il flag STARTUP_LOADER_SAFEMODE .
Metodo GetVersionFromFile Ottiene la versione di compilazione originale di .NET Framework dell'assembly (archiviata nei metadati), in base al relativo percorso del file. Questo metodo sostituisce GetFileVersion.
Metodo QueryLegacyV2RuntimeBinding Restituisce un'interfaccia che rappresenta un runtime a cui sono stati associati i criteri di attivazione legacy, ad esempio usando l'attributo useLegacyV2RuntimeActivationPolicy nella voce del <file di configurazione dell'elemento di avvio>, tramite l'uso diretto delle API di attivazione legacy o chiamando il metodo ICLRRuntimeInfo::BindAsLegacyV2Runtime.
Metodo RequestRuntimeLoadedNotification Garantisce un callback al puntatore di funzione specificato al primo caricamento di una versione CLR, ma non ancora avviato. Questo metodo sostituisce LockClrVersion

Commenti

L'unico modo per ottenere un'istanza di questa interfaccia consiste nel chiamare la funzione CLRCreateInstance come indicato di seguito:

ICLRMetaHost *pMetaHost = NULL;  
HRESULT hr = CLRCreateInstance(CLSID_CLRMetaHost,  
                   IID_ICLRMetaHost, (LPVOID*)&pMetaHost);

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

Vedi anche