Condividi tramite

Interfaccia ICLRMetaHost

Fornisce metodi che restituiscono una versione specifica di Common Language Runtime (CLR) in base al numero di versione, elencano tutti i runtime 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.

Methods

Metodo Description
Metodo EnumerateInstalledRuntimes Restituisce un'enumerazione che contiene un puntatore all'interfaccia ICLRRuntimeInfo valido per ogni versione CLR installata in un computer.
EnumerateLoadedRuntimes, metodo Restituisce un'enumerazione contenente un puntatore all'interfaccia ICLRRuntimeInfo valido per ogni CLR caricato in un determinato processo. Questo metodo sostituisce GetVersionFromProcess.
ExitProcess, metodo 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 versione CLR specifica. Questo metodo sostituisce la funzione CorBindToRuntimeEx usata con il flag STARTUP_LOADER_SAFEMODE .
Metodo GetVersionFromFile Ottiene la versione originale della compilazione .NET Framework dell'assembly (archiviata nei metadati), in base al percorso del file. Questo metodo sostituisce GetFileVersion.
Metodo QueryLegacyV2RuntimeBinding Restituisce un'interfaccia che rappresenta un runtime a cui è stato associato un criterio di attivazione legacy, ad esempio usando l'attributo nella <startup> voce del file di configurazione dell'elementouseLegacyV2RuntimeActivationPolicy, 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 quando viene caricata una versione CLR, ma non ancora avviata. Questo metodo sostituisce LockClrVersion

Osservazioni:

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.

Intestazione: MetaHost.h

Biblioteca: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile da 4

Vedere anche

  • Last updated on